NOW IS THE TIME 

TO CATCH UP ON ISSUES 
YOU HAVE MISSED 



VOL 2 No.5 fUL/AVC '89 
FONT FACTORY ■ Create your 

HIRES DEMO KIT - Add music 
to your favourite picture. 
ANIMATOR - Get Ihose sprites 
moving 

BORDER MESSAGE SCROLL - 

Say whal you like along Ihe 
bottom of the screen. 
TYPIT-128 - Create professional 
text layoul on your CI 28 
SCREEN COPIES UTILITY - 
Download your favourite 
screens, including CDU paint 
files. 

VIDI-BASIC - Graphic based 
extension to Basic. 
64 NEWS DESK - Become a 
C64 reporter. 



VOL 2 No.6 SEP/OCT '89 
MICKMON - An extensive M/C 

SCRAPBOOK - Collectors and 
hobbyists database. 
CELLRATOR - Enter the caves 
if you dare. 

RAINBOW CHASER 

Rainbows means points in this 
unusual game. 

HIDDEN GRAPHICS - Utilise 
those graphic screens. 
FORTRESS - Save the world! 
Yet again. 

DISK HUNTER - Keep tabs on 
volii disk library. 
SUPERFILE - One more for the 
record keepers. 



VOL 3No.1 NOV '89 
BASIC EXTENSION - Windows 
and Icons the easy way. 
B-RAID - Vertical scrolling 
shoot 'em up. 

DISKONOMISER - Prudent 
disk block saving. 
HELP - Design your own 
information help screens. 
ORSITAL - An arcade style 
game with a difference. 
PROGRAM COMPARE - Basic 
program development has 

RASTER ROUTINES A few 

colourful demos. 

SPRITE EDITOR 1 - A no 

notiM.'iise basit sprite editor. 
WABBIT - Help the rabbit 
collect his carrots. 



VOL 3 No.3 /AN -90 

4 IN A ROW - Connect a raw of 

FROGS IN SPACE - Leap to safety 
across the space lanes, 
BLACKJACK - Don'l loose vour 

shin. 

LORD OF DARKNESS - Defeat 
the evil lord in true adventure 
style. 

MARGO - Fly around and collect 
jewels and fuel. 

(ETRACE 2000 - Have you got 
whal it takes to be best? 
ULTIMATE FONT EDITOR 

Create your own screens, layouts 
and characters. 

SELECTIVE COLOUR RESTORER 

- Design your own system start 
up colours. 

6510+ UNASSEMBLER - 

Transform 65HI+ M/C into source 
with labels. 

TRIVIA CHALLENGE - The first 
of i lilies lor this superb game. 



VOL3No.4FB8 '90 
COLOUR PICTURE PRINT 

Download your favourite 

BASE-ED2 - An update to our 
popular database system. 
1ST MILLION - Play the market 
in this strategy game. 
FM-DOS - Enhance your drives 
operating system. 
CEOS FONTS - A further 4 
fonts for Geos users. 
HASHING IT - Relative file 
programming made easy. 
MULTI-SPRITE - Make full use 
of up to 24 sprites. 
DIRECTORIES EXPLAINED 
Find your way round the 
direciory jungle. 
TRIVIA CHALLENGE - The 2nd 



VOL 3 No.5 MAR '90 
PLAGUE - Become your 
planets Guardian and 
Defender. 

SURROUND - Reversi on Ihe 

CM 

GEOS FONTS - The last of 12 

neu Geos fonts. 

SCREEN SLIDE - Create your 

JOYSTICK TESTER - Put your 
sticklsl through the mill. 
COLOUR MATCHER 

Mastermind for the younger 

SCREEN MANIPULATOR - Full 
use of the screen now 
obtainable. 

VIDEO RECORD PLANNER 

Keep lab on your home 
recordings, 

TRIVIA CHALLENGE - The 3rd 

and final part of the game. 



Back issues of CDU are available at £3.25 per issue, which includes postage and packing, 
orders should be sent to:- Select Subscriptions Ltd, 5, River Park Estate, Berkhamsted, Herts, HP4 
1 HL. Please allow 28 days for delivery. 
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INSTRUCTIONS \ 

EDITORS COMMENT 



There I was silling at the blank 

say for this months editorial spot, 
when I was suddenly brought bark 
to reality by the noxious sounds ol 
the telephone bell. To say the caller 
was somewhat irate would be an 
understatement. "What the heck is 
happening wilh my submission" he 
wished to know. "Don't you know its 
now nearly eight months since it was 
accepted lor publication, when is it 
going to appear in print". The simple 
answer that I gave him, and this goes 
fur EVERYONE else that is waiting to 
see their masterpiec es appear in print 
is this; I cannot give ANYONE a 
definite date for publication. Please 
try to remember that we only publish 
approximately ten programs each 
issue. We also TRY not to repeat 
programs too often. That is to say, if 
we publish a SPRITE EDITOR, we try 
not to publish another one too soon. 
Therefore, trying to select original 

programs gets harder and harder all 
the time. On top of this, don't forget 
that we are accepting programs e,« h 
and every week, therefore the library 
oi accepted programs is growing at a 
greater rate than the publication rate. 
All I can say is this: PLEASE be 

patient If you have had a 
program/article accepted for 
publication. We WILL publish it 
eventually, it's just a matter of lime. 
(If it is of any consolation to you all. 
my own programs, DISK TOOLBOX 
and LIBERTE took nearly 15 months 
before Ihey appeared in print. ..and 
I'm the Editor..!!). 

Anyway folks, once again I lhank 
you all for your fantastic support and 
letters of gralitude this pasl month or 
so. It really is heartwarming to know 
that the hard work you put into 
producing a good quality twhich it 
is} magazine, is so richly received by 
it's readers. Now on with the show.... 



DISK INSTRUCTIONS 

Although we do everything possible 
to ensure that CDU is compatible 
with all C64 and CI 28 computers, 
one point we must make clear is this. 
The use of 'Fast Luudi-rs', 'Cartridges' 
or alternative operating systems such 
as 'Dolphin DOS', may not 
guarantee lhal your disk will function 
properly. If you experience problems 
and you have one of the above, then 
we suggest you disable them and use 
the computer under normal, standard 
conditions. Getting the programs up 
and running should not present you 
with any difficulties, simply put your 
disk in the drive and enter the 
command. 



LOAD"MENU",8,1 



Once the disk menu has k 


aded you 


will be able to start an 


y of the 


programs simply be sele 


cling the 


desired one from the 1 




possible for some program 




the computers memory so 




will not be able to LOAD 


program. 


from the menu correctly 




reset the machine. We I 


herefore 



suggest lhal vou turn your computer 
off and then on again, belure Inarlmg 
each program. 

HOW TO COPY CDU FILES 

You are welcome to make as many of 
your own copies of CDU programs 
as you want, as long as you do not 
pass them on to other people, or 
worse, sell them for profit. For 
people who want to make legitimate 
copies, we have provided a very 
simple machine code tile copier. To 
use it, simply select the item FILE 
COPIER from the main menu. 
Instructions arc- presented on screen. 

DISK FAILURE 

If for any reason the disk with your 



copy of CDU will not work on your 
system then please carefully re-read 
the operating instructions in the 
magazine. If you still experience 
problems then: 

1 . tf you are a subscriber, return it lo: 
Select Subscriptions Lid 

5, River Park Estate 
Berkhamsted 

HP4 1 HL 

Telephone; 0442-076661 

2. If you boughl it from a 
newsagents, 

CDU Replacements 
Interceptor Croup 
Mercury House 
Calleva Park 
Aldermaston 
Berkshire RC7 4QW 
Telephone: 0734-817421 

Within eight weeks of publication 
dale disks are replaced free. 

After eight weeks a rep I art-men I 
disk can be supplied from Interceptor 
Croup for a service charge of £1.00. 
Return the faulty disk wilh a cheque 
or postal order made out to 
INTERCEPTOR CROUP and clearly 
state the issue of CDU that you 
require. No documentation will be 

Please use appropriate packaging, 
cardboard stiffener at least, when 
reluming disk. Do not send back 
your magazine, only the disk please. 

NOTE: Do not send your disks back 
to the above address if its a program 
that does not appear lo work. Only if 
the DISK is faulty. Program faults 
should be sent to: BUC FINDERS, 
CDU, Alphavite Publications Ltd, Unit 
20, Potters Lane, Kiln Farm, Milton 
Keynes, MK1 1 3HF. Thank you. 



4 



ON THE DISK 




n 



A very simple, yet effective program for keeping a track of your bank account. 

RICHARD TANNER DIRECT DEBITS 



The following program Is for CI 28 
users wilh BO column capabilities on 
iheir monitors. It will NOT work in 40 
column mode. Secondly, before using 
the program 'Banking 128', ensure you 
copy the file onto a blank disk. This is 
because the program creates it's own 
tiles and will need lots of disk space. 
Last, but not least, the program on the 
disk is a Basic version so that you can 
tailor it in meet your own needs. 

THE NITTY GRITTY 

When the program is loaded and run 
for the first time, you will be told there 
is no data file on your disk. This is 
correct because you have no files at 
present. From the displayed menu, 
select number 1 , which creates a blank 
datafile. The program asks for a date. 



this 



.t be v 



>f the 



ghl 



format (DD/MM/VY). Dor 
anything wrung will be rejected. Once 
the dalaiile has been created, press any 
key and the program will try again to 
load the datafile. Now you will get 
another message, that there is no direct 
debit file. This again is correct, because 
you do not need to have one. This will 
be explained later. You now have to 
enter today's date, same formal as 
before. The main menu is then 
displayed. 

MAIN MENU DISPLAY 

OPTS EXPLANATION 
1 Firstly this sorts the records, 
then saves them to disk. 



Inputs credits into the system, 
i.e.; money into the account 
(the explanation field is totally 
free text, but you must put 
something in). 

Inputs debits into the system, 
i.e.; money out of the account, 
(explanation field is as above, 
see option 8 for reasonl. 
Displays the current state of 
the account (total money). 
You can alter or delete a 
record, but you must have the 
date of the record handy. 



Prinl 



] these 



or printer starting from '. 
Sons the records into date 
order, you should hardly ever 
need to use this because every 



done! 



;yourf 



s, this 



Lists all your expenses (Debits), 
type in the text to search on 
(from the explanation fields on 
Credit and Debit) and all the 
matc hing expenses are 
displayed and totaled. This Is 
very handy for adding up all 
your cheques etc., don't forget 
that you need tri give a good 
explanation in 2+3. 
Takes you to the Direct Debit 
Editing menu, see below. 



This is where you enter your direct 
debits to be automatically taken out 
when loading the program again. You 
supply the starting dale of the Direct 
Debit, the text which when added into 
your account records, comes out in the 
explanation field, and the amount. 

This menu is mainly the same as 
the other one, hut don't forget this is 
another file and you must save it with 
option 4, if you don't then when you 
load the program back in, all will be 
lost. 

Once you have set up your Direct 
Debits, save them, and now the 
program is all set up for your first 
automatic withdrawal. Next time you 
load the program, all you will need to 
do is give today's date, this must be 
correct else the program will take out 
the direct debits missing from your 
files. 

The Direct Debits check the month 
before today's date, this month and 
next month. If any of these files are 
missing it automatically adds them in. 
The best thing to do with the program 
is to experiment. If you do not have 
any direct debits, don't worry, the 
program will just skip the automatic 
direct debit part and put you straight 
into the main menu. 

If you have any queries regarding 
this program, I will be pleased to help, 
lust write in to me c/o the magazine. I 
hope that this program tidies up your 
Ivink dt'i.iils for you. 
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THE DISK 



0 



DISK DRIVER V4 



Overcome the difficulties of talking to your drive with this 

X— A™ ^Stiacii'n; PAUL Cochrane 

many features. An ideal example of 

this is when the user wishes to F6 - Renameafile 

communicate with the disk drive. F7 - Read I he error channel 

'Disk Driver V4' has been devised to F8 - Initialise disk 
workload ofl 



latest drive utility program. 



the disk 
their m. 



e while they ai 



Some of you will be saying "But I 
have already got these features in my 
extended Basic", granted. Most 
extensions however, provide these 
features by adding extra commands. 
Disk Driver V4 goes one better and 
provides all these evlr.i utilities .il Ihe 
press of a Function key. The format 
for which is shown here: 



ng explanatory, a 
if I prompted. 



e 'sure (y/n)' 
appears, press the "Y" key if you are 
sure it's whaf you intend, otherwise 
press the "N" key. When a list of the 



Ihe dis 



t the 



F1 



Display directory 
Validate disk 
Load a file 



computer expects you lo 
file which you want to carry out the 
operation on. The highlighted cursor 
can be moved up through the files by 
pressing the 'CTRL' key, and can be 
moved down through the files by 
'COMMODORE' ki 



the 



■r the n 



thai 



s the space 



Whet 
vith 'ne> 



ii the n 



that 



expects you 
you wish to call the file. The RUI 
STOP key can be used to exit thi- 

li you select Ihe same functior 
key twice willniiil pressing any olhei 
key, the key will not register. This is 
to prevent the key being hi 



which < 



luld i 



; the 



computer to crash. To re-enable the 
function key press any other key. 

PROGRAM INFORMATION 

The 'Disk Driver V4' machine code 
resides in the area of memory from 
$C900-$CFGU The program works 
by altering the 'KEYLOG' vector at 
S028F to point to the Disk Driver 
routine. As 'KEYLOG' is a kernal 
vector, it is reset upon using RUN- 
STOP/RESTORE. To restart the 
program enter SYSS1456. 



km SCRATCH FILE whw 



"FC . MC" 

"BOOT-BASIC" 

"WINDOW DEMO" 

"PROG 1" 

"PROG 3" 

"LAND DATA" 

"SCREEN DESIGNER" 

"COMPILER 52000" 

"DRIVER U4 . CODE" 

"DEMO" 

"SAUER" 

"SAMPLEPLAVER . ASM" 
"MISC . TUN" 
"PIC2" 

"AW-DECOM. MC" 
"TECHNO INFO" 
"ALL CODE" 

SELECT FILE WITH: 
CTRL - UP COMM - 



"BOOT MC" 

"BASIC BANKING" 

"WINDOWS" 

"PROG 2" 

"LAND CODE" 

"PRICE CALCULATOR" 

"SCAD" 

"COMPILER CODE" 
"THE BOSS" 
"IDOS" 
"SAMPLEKIT" 
"MISC . SAM" 
"MISC . SPL" 
"PIC3" 

"AW-DECOM. SRC" 
"MAIN" 

"rjPIC LANDSCAPE " 



DOWN SPACE 
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C1 28 users can now get your CDU disks up and running with this autoboot program. 



OBfJU BVT S43,$42,$4D 


'cbnt' 


OBGi BVT S00,$00.$00 


boot sector control codes 


OBOfi BYT 5DO,$4D,$45 




0BO9 BVT S4e,S55,$00 


'menu' 


OBOC BYT $00 




OBOD SEI 




OBOE LDX #$00 


copy program to autostart 


0B1OLDA $0B1C,X 


SflOOOfrom $0BlCtoend 


OBI 3 STA $tt000 r X 




0B16 DEX 




OB17 BNE $0B10 




OB 19 |MP $FF4D 


CI 28 vector - G064 


061 C byt $09,sao,$oy 




0B1F BYT$80,$C3,$C2 




0B22 BYT $CO,$3B,$30 


•CBM80' 


0B25 |SR $FDA3 


in it I/O 


0B28 |SR$FD5D 




0B2BJSR SFD15 


reset KERNAL 


0B2EI5RSFF5B 




0B31 CLI 




OB32 JSKSE453 




OB35 ISK SE3BF 




0B3B |SR $E422 


check memory/title/NEW etr 


0B3B LDA #$05 


flle number 


0B3D LDX #$08 




0B3F LDY #$01 


m/i ondary address 


0B41 JSR $FFBA 


kernal SETLF5 


0B44 LDA#S04 




0B46 LDX #$3C 


name address do] 


0B48 LDY #$S0 


name address (hi) 


UB4A ISRJFFBD 


kernal SETNAM 


0B4D LDA #$00 


$00= load 


0B52 LDX #SFF 


reset slack pointer 


0B54 TXS 


OB55 )MP SE3B6 





KARL HOPE 



You will all be aware that the CUB 
has an autoboot feature for disk 
users, this useful tool could be a 
great time saver for us CI 28 users 
that purchase CDU each month. We 
simply have lo insert the disk and 
turn on I he computer to access the 

two copies of the program on this 
months disk. One being the machine 
code (which boots to $UB00 ■ C128I, 
Ihe other being a Basic listing of the 
disassembly. 

For those thai may be interested, 
here is a copy of the listing. 

NOTE: Those of you who are curious 
and have studied the C64 ROM will 
notice that in a normal initialise the 
C64 will reset the stack to #SFB 
whilst I have set it to #$FF. The 
reason for this is that the C64 holds 
return addresses after a )5R on the 
stack. My program was loading the 
files from the menu and then loading 
the menu again straight away. The 
extra four bytes usually on the stack 
will have been the two addresses at 
the beginning of the autostart 
program, which nalurally point to my 
program, this being the reason why it 
constantly reran. 
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READING BETWEEN THE LINES 



Any adventurerer will tell you that an adventure is only as good as the parser. Now you can 
develop your own with relative ease. 



Have you ever told a computer 10 


GORDON MOYES 


presenl) ihe attion equals the verb. If 


'Chop down the western door with 








the axe', then had a reply like 'where 


Lill [If m> north ind set the axe; 


routine checks through the action list 


did you learn English?'. The "Parser" 


viio is poiri 


to git the axe. you nr 


to set H it tan march both the verb 


utility presented here may tome to 


he Elf? Thin 


become much rlparer 








Say to the Mil lit "go 


(torn ■■..! Mcceed the* .1 outputs d 


This parser is intended for use as 


north and get the a>e" 




a front end for adventure programs, 
but can be used anywhere that you 
need a computer to understand 


Many 0 


utputs are therefore 
.T'dlyse t-vf'y word, 
al ol Ihe oulpuls fmfn .1 


The object combination -online is 
similar to the action combinjt-on 


equired tc 
Table 1 lists 






oriillirl.llio 


routine, whn h greatly 


ddje<tive and I noun and an 


machine language because Basic is 


edui e llio 


umber oi variables thai 


unlimited number ol ■djectfeei may 


simply too slow. This does not, 


irogram. 


e used by the main 


appear in the olijei 1 list 1 -, instead ol 


program must" also' be' in machine 






and is more or less irrelevant. 


language. 


ACTION/OBJECT 




COMBINATION 


THE MAIN PROGRAM 


THE SYNTAX 


"ho tii [ion antl object 1 ornh nations 


Lines 7000-7070 define the variables 


The first thing that must be done 


are both ca 


ed by 5YS49161. Their 


in the machine code program. Nole 


when writing a parser is, of course, 


jurpose is 


1 reduce ihe number of 


that FNP(X) Is Ihe same as 


to define the syntax ol Ihe language. 


■■in. llilcs ih.il iho main program must 


PEEK(50040+X) throughout the 


The basic command structure for this 


Work with, Tho action combination 


program. 


parser is (verb) (verb supplement! 


combines 


Te verb and ihe verb 


Lines 70BO-71 30 input a 


(objectl) (verb supplement) 


■■u up lemon 


into one variable, the 


command siring from the user and 


(preposition) (object2), where an 


action. It works like this: If the verb 


puts it into the parser input buffer 


object is defined as (owner) 


supplemen 




along wilh ils length. 


(adjective) (noun). EG: Pick up the 














leather saddle under the big tree. At 


FNPfX) 






the end of a command. there, may hi-: 


0 


Verb 


Verb position 


a full stop, comma, quote or joiner 


2 


Verb 5up 


Sup position 


which may seperate another 


4,5,6 


Owner 1 ,2,3 7,8,9 Owner position 


command. 


10,11,12 


Adj 1 ,2,3 


3,14,15 Adjposition 1,2,3 


Note that, although the verb 


16,17,18 


Noun 1,2,3 


9,20,21 Noun position 1,2,3 


supplement can appear in one of two 


22 


Preposition 


3 Preposition position 


places, it can only be in one place in 


27 


Say verb 


8 Say vera position 


29 


Say prep 30 Say prep position 


'Pick up the axe up'! Also, an object 


24 


I. nor '.we lable 21 




may be replaced by a pronoun. The 


25 


More; 0 if end of line reached. 1 if more 


pronoun will be taken as the last 


26 


Say More; 1 it still in quotes and more =1 


owner/adjective/noun combination 


31 








32 


Object 1 




If speech is involved, the 


33 


Object 2 




beginning of a command will be (say 


34 


Object 3 




verb) (say preposition) (object.il ("). 








Quotation marks are required around 


PA 


Position in wotd bufter parser is up 10 


the speech so the parser can tell 


BF 


Start of buffer 






OU 


Start of output variables 










TABLE 1 - Parser Variables 


sentence. IE: In the sentence. Say to 









1 There b no noun with object'l 

2 There is no noun with objeel I 

3 There? is no noun with object 3 

4 Some sentence is left over after 

parse Is done 

5 No first quote in say command 

6 Word is not recognised at all 

...(The position of the word that 
the parser got stuck at is in PAI... 

TABLE 2 ■ Errors 



Line 7140 points the input buffer 

resets the more and saymore 
variables so the parser can function 
properly. 

Line 7150 calls the parser. 

Line 7160 checks for any 
confusion between a verb 
supplement and a preposition. If 
there is no preposition, a second 
object and a supplement (which can 
also be a preposition i.e. on/to) then 
they are swapped before line 7170 
calls the combination routines. 

Lines 7180-7500 print the parser 

Lines 7300-7320 print out the 
word that the parser got stuck at if 

unrecognised objects and actions do 
not show up at this stage. 

Lines 7330-7410 check through 
the three objects to see if they are all 
rt-cognised or not present. Il they are 
unrecognised, the program prints out 
the unrecognised section by using 

Lines 7420-7490 check to see if 
the action is recognised. If it is not 

printed out with the print on list 
routine. 

Lines 7510-7550 wait until the 
space bar is pushed before printing 
out another list, if there was more 
than one command on the line thai 
was just entered. 

PRINT FROM LIST 

When the inputed object is 
unrecognised by the main program, 
it would be handy to be able to tell 
the user this. To use this command, 
POKE PA with the list number (see 



table 3), POKE PA+1 with the words 
position In that list and SY54915B. 

command in lines 7370-7400 and 
7450-7480 to let the user know of 
unrecognised objects and 
commands. 

PRINT FROM BUFFER 

This command is used to print out 
unrecognised words. Il is called by 
SYS49155 when PA contains the 
starting position of (he word in the 
buffer. Note that when an error 
occurs, PA will contain the starting 
position of the word that the parser 
got stuck at. The main program uses 
this command in line 7310 every 
time an error occurs to let the user 
know where it became stuck. The 
error number will indicate why the 
parser became stuck (see table 1 ). 

THE WORD READER 

The purpose of the word reader is to 
read in the computers vocabulary. 
You can change this around as much 
as you like fo suit your own 
adventure. The starting address can 
be changed to suit your needs, bul 
remember to protect it from Basic. 
Every word stored is followed by a 
number. This is the word number 
that is returned by the parser and is 
used to group words that mean the 



njmwi that is returned dsiingu<sr>cs 
between wonts thai mean the lame 
Ihmg so that they <an be printed 
iron- the data lists. 

Every item of action data must 
lake the form (action) (verb) (verb 
supplement], with a zero byte 
marking the end of the list. The first 
entry of 1,200,1 translates to: If verb 
is 200 (pick) and supplement is 1 
(up) then the output will be 1 (the 
same as get or take). 

as (object) (noun)'(adjl ) Iadj2) .... 
larij n) (255), again with a zero byte 
marking the end of the list. Note you 
can have as many adjectives as you 
require in the list. The first entry of 
5,5,5,6,255 therefore means that if 
the noun is 5 (horse) and the 
adjective is either 5 (skinny) or 6 
(small/short) then the output will be a 
5. Note that the same output ts 



0 


Verbs 


1 


Verb Supplements 


2 


Nouns 


3 


Adjectives 




Owners 


5 


Pronouns 




loiners 


7 


P repositions 


8 


Say verbs 




TABLE 3 - List Numbers 



UBJECI2 -OHO 3 

0BJECT3 : 6 H 0 25 

PREPOSIT: O S 

SAV UERB: O 0 

SAY PREP : 0 255 

SflV MORE: 0 

MORE : 0 

ERROR : 6 

I GOT STUCK AT JUG 



ACTION : 1 UERB 1 

OBJECT1 : 0 N O 6 

0BJECT2 I) N 0 3 

0BJECT3 : 0 H O 2 

PREPOSIT: 0 G 

SAV UERB: O 0 

SAY PREP: O 255 

SAV MORE : 0 

MORE : 0 

ERROR : B 
I GOT STUCK AT KEV 



O UERS 0 
AO 1 0 i 
AO 3 0 0 
55 A 0 OO 
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OBJECTS 




ACTIONS 


SAV VERBS 








1 Say/tel 1 








2 Shout/yell 


3 West 




throw^wa^ P " 






1 KickmlTAili 


JOINERS 


5 Horse 


. , ma ||t| ( j nnv 














7 Elf 


; tall/blue 


6 Chmo/astend/ our>/climb 


OWNERS 




; pointy /wood 


7 De5l:enayKo ^ dowrl^hmh^clw |, 


1 A/- /.U.I 


9 Armour 












PRONOUNS 


11 Bars 


; large/metal 


1 0 Wear 


1 It/them/him/her 


12 Saddle 




1 1 Open 




13 Goblin 


; big/fa t/o range 




PREPOSITIONS 


14 Door 


; north 


13 Put 


t At 


15 Door 


; south 


200 Pick 


2 With/using 






201 Chop 


3 Near/around 




; east 


202 Dig 


4 Under 








5 On 


20 1 Door 




1 ABLE 4 - Parser Vocabulary 








The code presented here is only a 


EDITORS NOTE:- 1 think that this 


The main use o 




front end for an adventure program. 


program enhances our 'Adventure 


inly valid arijet 




It is up to you to subslitute the 


Writing' series quite considerably. 






sample main program given here 


You should be able to put your new 


wo different Eh 




with your own adventure program. 


il.nnpfl knnwk-ilHi: id wime good use 


here. 




Manv happy adventures to you!! 


in the very near future... .PAE! 




AMIGA C1281 



| LIGHT GUN] £36.50 



I printersI l ew light f^tasticI 



C 1VI « CROFTON MlfRO SUPPLIES IW1 AtJA 
\_.l¥l.i3 45 Vv'HITBREAD ROAD VOI-1V7 
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If you are new to a Commodore disk 
drive you are problably Thinking 
"where's (he Commands?" or "How 
do I delete a file?". Well believe it or 
not, the Commodore dink drives do 
have commands but rhey are VERY 
difficult lo get used 10. To delete a 
file from a disk you have to type in 
the following; 

OPEN15,8,15,"SO:filename":CLOSE1S 

To delete a file on a BBC machine 
you only have to type; 

•DELETE filename 

Now. which is the easiest to 

MMbtri Nn ronnHil iin. "he BBC 
lorurdiid system heats Comi endures 
hands down. Yei the Commodore 
disk drives *<v probably the most 
advan.eri and ve-satde d<sk dm* 
systems availab'e for an tj-bil 
machine. 

A BIT OF HISTORY 

So why are the Commodore disk 
drives the most difficult to use? It all 
lies with a decision made by 
Co mm ixl ore a long time ago when 
the VIC-20 was screaming for a disk 
drive. As you will probably know, 
the VIC-20 only had 3.5K, so there 
was no way that a whole disk 
operating system could be crammed 
into this mlcr-machine. C'omnniduci' 
in theif infinate wisdom therefore 
decided to put the disk operating 
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proved to be both a boon and a 
bain, this meant that only slight 
alterations had to be made to the 
VIC'S ROMs and thus saving a lot of 
memory, it also meant that the disk 
drive could be doing something 
while the computer did something 
else. It also meant, land this has only 
been utilised recently), that the disk 
drive acted like a computer in itself 
and two could be connected 
together without a computer; once 
they had been programmed; and talk 
to each other. They could for 
example, copy disks from one drive 
to the other while the computer did 
something totally different. 

This was impossible on any other 
disk drive system. One problem was 
that the disk drive system was serial 
which meant that the whole system 

fortunately depending on how you 
look al it, the VIC-20 disk drive had 
to be compatible with the all-new, 

machine, Ihe Commodore 64. So the 
same ROM-on-drive, slow-serial 
syslem was retained. And not much 

back lo the reason for this article, to 
gel ihe drive system communication 
through the serial cable has to be 
done manually, hence the 
complicated commands. Well, now 
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commands because I have- devised a 
program which handles all those 
commands through a BBC-like 
interpreter. 

THE INTERACTIVE DISK 
OPERATING SYSTEM 
(IDOS) 

IDOS is an Interactive program lor 
use with the C64 + disk drive, which 
allows the user to manipulate their 
disk with ease. Commands range 
from the simple LOADing and 
SAVing of program files to locking 
files against erasure. Other 
commands allow the disassembling 
of machine code programs directly 
off disk without first loading them 
into memory. 

All commands are accessed 
through a very Basic-like interpreter 
which allows abbreviations by the 
use of a full stop (.). This also allows 
ALL commands to he acc essed from 
outside the interpreter i.e. irom Basic 
programs or direct mode. IDOS does 



except LOADing, so once the 
program has be LOADed off disk it is 
ready for use, no SYS calls to 
remember! 

IDOS interacts with the 
operating syslem by use of a vector 
system which the C64 uses to lest if 
there is a cartridge installed. 
Locations $8004 to $8009 usually 
hold garbage, but if it contains $C3. 
$C2, $CD, $38, $30 CCBM80') 
then ihe machine gives control over 
to Ihe vector held in $H000 and 
$aooi. IDOS simulates this so on 
pressing RUN/STOP and RESTORE 
the machine jumps to the address 
held in S8002 and $8003. Usually 
this would stop any warm starts but 
a bug Ifrfl in the operating system 
also does this if only the RESTORE 
button is pressed, so IDOS is run by 
pressing RESTORE. If RUN/STOP is 
also pressed then a normal warm 
start occurs, very useful for 
breaking out of IDOS or any other 
program. - 

THE COMMANDS 

The commands are shown in BOLD; 
< and > denote single parameters. 
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e.g <filename> means a filename is 
required NOT enclosed by quotes. 

I to 



contain spaces MUST u ; 

spaces. (IDOS automatically changes versic 

them to normal spaces), as IDOS VERIF' 

uses spaces as parameter separates, and 

Any parameters that are enclosed by convir 

I and I are optional and can be corrup 

HEXadecimal, all other numbers ai 
in DECimal. Filenames may ccinta 



problem is. (Usually with Machine 
Code programs, the program alters 
itself and so the version on the disk 
will be slightly different from the 



iuld g 



; VERIFY ERROR 



LOAD ^filenames |<addr>| 

This loads a program under the 
filename <filename> from the disk 
into memory at address <addr>. if no 
address is given then the default is 
the address specified by Ihe program 
header (i.e. where It was saved from. 
Minimum abbreviation: L 



NOTE: the LOAD/SAVE operations 
do not use (he normal ROM roulines 
for LOADing.SAVEing, instead IDOS 
uses it's own. By using the ROM 
routines OPEN.CHKIN.CHKOU T. 
CHROUT,CHRIN it does read/write 
operations manually. The advantage 
of this it thai the number of blocks i 

immedialely see how much of the 
program has loaded. It also means 
that IDOS has control all the time so 
the LOADing and SAVEing can be 
stopped by pressing the RUN/STOP 
key. Even better, it allows relocation 
of LOADing and SAVEing data. 

VERIFY <filename> {<addr>| 



parameters are 
LOAD though, the progi 
actually entered inl 



memory. At the end of ihe VERIFY, 
the number of mismatched bytes is 
shown, unlike the ROM VERIFY 
routine which just shows whether all 

rouline gives actual numbers 



Example: 

> VERIFY HIRES.CODE 
Minimum abbreviation VE 

SAVE <filename> |L) |<addr>| 
|<addr>] |<addr>| 

This is probably the most useful 
command, it allows a block of 
memory to be saved much like the 
BASIC SAVE command but a number 
ol useful additions have been made. 
Firstly the command automatically 
uses 'Save & Replace', lArrgh! I hear 
some of you cry, there has been a lot 
of rumours in the corridors of 
Commodore about (he safety ot this 
command on Ihe 1 541 , hut (here has 
been just as many rumours about 
ways to beat this bug. One of the 
safest is using <80: inslead of just Sr. 
Anyway, I own an Oceanic OC-11B 
which does not have this 
bug!... (Editors extra note: I have used 
@0: since 1984 and have NEVER had 
a problem of any description.. ..Edlll, 
which replaces the current version 
on disk with the new version. The 
'Save & Replace' can he switched off 
by Ihe KEPLACEOFF command (see 



■l.iri address, il it is not given or 0' is 
used then the slart of current Basic 
program is used. li.e. held in 
locations 43 and 44). 

The second |<addr>| is the 

n|)li(.in.]| end address, il il is not given 
or ■&" Is used then the end of the 
current Basic program is used (i.e. 
held in locations 45 and 46). 

The third l<addr>| is the optional 

then no relocation occurs. ^This 
allows a block of memory to be 
saved from one area in memory but 

memory. Very useful when saving 
sprite or character data. 

The |L| is a very quick and useful 
way to protect a file against 
accidental erasure, it locks the saved 
file so it cannol he erased (unless you 
unlock it of course). 

Examples: 

SAVE IDOS L 8000 A000 

Will save IDOS onto disk and lock it 

(From SSOOO to SAOOt) where IDOS 

SAVE PROGRAM 



Minimum abbreviation: S 

EXEC <filename> (<addr>| (<addr>), 
RUN <fiTename> f<addr>| [<addr>| 

These commands load and execute a 
program off the disk. It uses the same 
parameters as the LOAD. The first 
<addr> is the load address and the 
second is the execution address. If no 
address is stipolaled the program is 



sihle 



lb.' 



COMMANDS : - 

LOftD <FILEHHME> E<flDDR>] 
"ERIFY < F I L E N A ME > E<ADDR>J 
t<flDDR>J tL1 C<ftDDR > :l E<flDDR>] 

EXEC <FILENAME> E < ADDR> ] E<ADDR>] 
C 0 MMA H D < C 0 MM A ND>" t<««>DR» 
CAT E<FILENfl ME > < F 1 LE N A ME > . . . ] 
R. I .R„ t<FILEHflME > <F I L EN AME > . . . ] 
DUMP < F I L E H ft ME > E<flDDR>J 
PRINT CF I LENflME > 

type <filename> 

list <f i l en ame > c <l i he number} j 
diss <f i l en ame > e < a ddr > ] 
size < f i l e n a me > 
rename: <newname> coldname> 
1ddname <newname> < 0 l d n a me > e < ad d n ame> < 
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Example: 

>COPY HIRES-CODE1 I 




COMPACT, VALIDATE 

These commands validat 
disk. Equivalent to VO. 



Example: 

>EXEC MC-GAME COOO 

Minimum abbreviations: E for EXEC. 

R for RUN 

COMMAND <command> 

This pulputs a normal D05-type 



CAT |<fileriame>] |<filename>...|, 
DIR {<filename>) |<filename>...| 

These commands display the 
Directory of the current disk, the 
filenames are optional and allow fur 
selective cataloging. 



D for DIR 

PRINT <filename>, DUMP 
<filename> (<addr>|, TYPE 
<filenamo>, UST <filename> 
l<linenumber>|, DISS <tilename> 
l<addr>| 

All these commands displ.iy file dau 
from the disk to the screen but in 
different ways. DUMP displays a 
x and ASCII dump of a file from 



lists a Basic program out from the 
disk to the screen from 
<linenumber> onwards, if no 
llnenumber is given then il is listed 
from the start. DISS disassembles a 
machine code program from the disk 



the 



from 



:addn> 



onwards. If no address if given then 
the start address Is used. All these 
commands can be used on PRC, 
USR and SEQ tiles. The output of a 
file to the screen ran be paused by 
pressing CTRL, SHIFT, SHIFT LOCK 
or the COMMODORE KEY, or 
stopped by pressing the RUN/STOP 

>DISS*H IRES-CODE 
Minimum abbreviations: DU for 
DUMP, LI for LI5T, Dl for DISS, T for 
TYPE, P ior PRINT 

SIZE <filename> 

This ihows the size of a file in blocks 
and bytes, it also shows where the 
program would be situated in 



RENAME <newname> <oldnamu> 





address is 


This renames a file on d 


given then the start of (he 




<!>ldname> to <newname>. 


PRINT prints out a file 








ny control 


Example: 


characters at all. TYPE is 


ike PRINT 


>REN AME HIRESCODE 






CODE 


including control chara 


lers. LIST 


Minimum abbreviation: RE 



SCRATCH <frlenamc> 
l<filename...>], DELETE <filename> 
l<filename>...[, ERASE <filertame> 
l<filename>...] 



1,1-, 



's from the disk. 



Example: 

> DELETE HIRES-CODE I 
Minimum abbreviations: SC for 
SCRATCH. DE for DELETE. ER for 
ERASE 

DISKNAME <diskname> 

Renames the current disk to 
<dlskname> 

Example: 

>DISKNAME BA5IC PROGRAMS 
Minimum abbreviation: DISK 

NEW <diskname> {<id>}, FORMAT 
<diskname> |<id>| 

These commands format the current 
disk with the name <diskname> and 
ID <id>. WARNING: There is no 
'Are your sure' routine, once the 
RETURN key is pressed the 



Example: 

FORMAT NEWDISK ID 

Minimum abbreviations: N for NEW. 

F for FORMAT 



This initialises the i 



I! 
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Example: 
>INIT 

Minimum abbreviation: I 
DERR, ERROR 

These commands read (he disk error 
channel anil displays It 

Example; 

>DERR 

Minimum abbreviations: DER for 
DERR. ERR for ERROR 

PROTECT <fi1ename>, LOCK <filenamc> 

These two commands lock the given 
lilt agLiinsl erasure. Equivalent to the 
L in the SAVE command. 

Example: 

>LOCK HIRES-CODE 

Minimum abbreviations: PRO for 

PROTECT. LOC for LOCK 

UN PROTECT <ffiename>, UNLOCK 
<filename> 

These commands are the reverse of 
the above, i.e. they allow for the 
deletion of the given <filename>. 

Example: 

UNLOCK HIRES-CODE 

Minimum abbreviations: UNI. for 

UNLOCK, U for UNPROTECT 

NOTE: A locked file has a '<' after 
the file type in the directory. 
E.G. 33 "IDOS" PRC< 

RECOVER <filename>, UN SPLAT 
<filename> 

These commands restore a tile which 
has not been properly closed (i.e. has 
an '■" before the file type). The file 
can now be opened and read from so 
restating it. 

Example: 

>RECOVER FILE 

Minimum abbreviations: REC for 
RECOVER, UNS for UNSPLAT 

ADDRESS <filename> |<addr>] 

This command allows you lo change 

the LOAD address of any file to 
<addr>, if no address is Riven, ihen 
the start of Basic is used. This is 
equivalent lo the third <addr> in the 
SAVE command. 



Example: 

■ Al inRCSS SPRITEDATA 4000 
DRIVE <drive> 

This changes the drive you are 
working on to <drive>. <drive> must 
be between 0 and 3 or the program 
will respond with ERROR: ILLEGAL 
DRIVE. It does not alter the number 

which the program uses i-see below]. 

Example: 

>DRIVE 0 

Minimum abbreviation DR 

DEVICE <drive> <device> |<drive>[ 
|<device>...} 

This alters the device numher which 
the program uses for <drive> to 
<device>. The program uses 4 preset 
device numbers, one for each ol the 
drives, Ihis command alters these 
presets. On loading they are set up as 
follows: 

DRIVE DEVICE 

0 8 

1 9 

2 10 

3 11 

The command alters the preset 
device number for drive <drive> to 
cli-vice sdevice>. This may not seem 
like a very useful command, but it 
can be. Imagine that you own all 4 
drives. One of which is a 1 541 , two 
are 1581s and the last is an Oceanic 
OC-118N. The 1541 must have a 

cannot change it wilhnut opening up 
the disk drive, the other three do 
have device changers and so they are 
set to 9,10 Ithe two 158Vs) and 11 
the Oceanic. II is obvious that you 
would want one of the two 1581'sto 
be drive 0 because they have a 
bigger capacity, the OC-118N would 
be drive 1, the other 1581 drive 2 
and Ihe poor old 1541 would be 
drive 3 (because of it's slowness and 
bu^sl. Normally ihis selup would be 
impossible, but with IDOS it is 
possible. 

Example: 

sDEVICEOB 1 9 

Minimum abbreviation: DEV 



HEX |<dec numbers] 

This simple command converts a dec 
number into a hex number and 

Example: 

>HEX 57344 

Minimum abbreviation: H 

DEC |<he* numbers] 

This is the opposite of the above, i.e. 
it changes a he* number into a 

>DEC P F1CA 

Minimum abbreviation: DEC 
CALL |<addr>} 

This command Is the same as the 
Basic SYS command, it jumps to a 
machine code subroutine. 

Example: 

sCALL C000 

Minimum abbreviation: CAL 
RESET (<addr>) 

This does a system reset and sets the 
Basic start address to <adrir> (see 
belowl. Equivalent to SYS64738. 

Example: 

> RESET 

Minimum abbreviation: RES 
BASIC (<addr>) 

This command sets the start of Basic 
to <adrir>, if no <addr> is given then 
the current Basic program will be 

NEWed. 

Example: 

>BASIC0801 

Minimum abbreviation^ 

COLOUR < border col> <screen 
cols <text col> 

T'-ii-i command sets the colours of the 
screen and the colour presets of 
IDOS. 

Example: 

>COLOUR6 15 6 
Minimum alibri'vialion: COL 

PROMPT <prompI-te*t> 

This command sets the prompt for 
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IDOS. normally il is set to a V but this 
command allows you to change II. 
Using a backarrow inserts a carriage 
return in the string [CHR$(13», the text 
can be anything up to 40 characters in 
length. To get no prompt just type in 
PROMP and press RETURN. 

Example: 

>PROMP ENTER COMMAND> 
Minimum abbreviation: PROM 

ERRON, ERROF, TEXTON, TEXTOFF, 
READON, RE A DOFF, REPLACEON, 
REPLACEOFF 

This set of commands are flag setters. 
ERRON and ERROF F control DOS error 
messages output. When switched off, 
no 00 OK 00 00's are outpurted, but all 
others are (eg 30 SYNTAX ERROR 00 

an. 

TEXTON and TEXTOFF control the 
output oi certain types of text, ihese are 
the LOADing and SAVEtag messages 

(BLOCKS S— and ADDRESS $ 

$ 1 and ALL DOS error messages. 

READON and REAOOFF control the 
reading of the first two characters in a 
file, in program files this refers to the 
LOAD address of the file. It is most 
useful in DUMPing a file as it allows 
you to see how long the file is (the first 
two numbers in the dump will he the 
LOAD atidressl. 

REPLACEON and REPLACEOFF 
control the 'Save and Replace' 
command in the SAVE. When it is ON 
then the form @0:filename will be used, 
when it is OFF then the form Oifilename 
will be used. I included this because 
same people are worried about ihe 
safety of the replace command. 

Example: 

>ERROFF 

Minimum abbreviations: ERRON 
for ERRON, ERROF for ERROFF, TE 
for TEXTON, TEXTOF for TEXTOFF, 
REA for READON, READOF for 
READOFF, REP for REPLACEON, 
REPLACEOF for REPLACEOFF. 

EXIT, QUIT 

These commands exit you from 
IDOS to the READY prompt in Basic. 
This routine will break you out of the 
current program (whether it is Basic 
or M,n hine Code). 



Example: 

>QUtT 

Minimum abbreviation: EXI for EXIT, 
Q for QUIT 

HELP 

This command lists all the 
commands with their syntax, useful if 
you have forgotten how to use a 
command. 

Example: 

>HELP 

KILL 

This command disables IDOS and 
exits you from it. II is possible to 
restore IDOS easily (see later). 

Example: 
i KILL 

Minimum abbreviation: K 



IDOS IN USE 

The program is accessed by pressing 
the RESTORE button only (either in 
program or direct mode) or by typing 
5YS32780. The screen colours will 
change to the preset colours (altered 
by the COLOUR command), there 
should be a greeting message and the 
disk error channel displayed (unless 
ERROFF or TEXTOFF has been 
executed). 

INTERACTIVE DISK OPERATING 

SYSTEM MK4.0 

BY RICHARD DAY ©1989 

00, OK.OUOO 

A prompt (usually '>', but altered by 
the PROMPT command) and a 
flashing cursor should appear. This 
means that IDOS is wailing for an 
input, so lype in a command along 
with any parameters and press 
RETURN. 

If IDOS responds with; 

ERROR : COMMAND NOT 

RECOGNISED 

Then you have not typed in a 
known command. To exit IDOS type 
EXIT. QUIT or iheir abbreviations. To 
perform a normal warm start hold 
down the RUN/STOP and press ihe 
RESTORE bullcm. 



ACCESSING COMMANDS 
FROM BASIC 

I mentioned before that all the 
commands are available from Basic, 
well they are. To access any 
command from Basic immediate 
mode or program mode type; 

SYS32777,<command>. 
The command MUST be in a string 
(i.e. inside quotes), this allows the 
following:- 

SYS32777, "DELETE -+F1S+" "+F2S 
Some useful SYS calls are; 

S\SJ2/?7,<command> Execute 
command 

SYS32780 Enter IDOS 

SYS327B3 Enable 
IDOS 

SYS32786 Disable 

IDOS (same 
as KILL 
command) 



GENERAL POINTS 

IDOS resides in (he block ol" memory set 
aside lor cartridges (S8tKK)-SAOO0), so it 
will not work with Jrly sorl ol i .indole 
system installed. IDOS cannot be 
relocated at all, even if you were to 
change all Ihe references in the 
program, the RESTORE entry system 
would not work. 

Now I have a slight confession to make, 
ihere is a bug in the program, but before 
you start worrying it cm hi- ea.silv over- 
written. Sometimes the UNLOCK/ 
UN PROTECT routine does not work. I 
do not know why, maybe my drive is 
playing up, but it is not permanent. If 
you do find Ibis hm; apiJturirijj i ontinui- 
using the UNLOCK/UNPROTECT 
command and CATaloging unlil Ihe file 
is unlocked, believe me it will. 



AND FINALLY 

And finally, my advice to you is to 
experiment, be careful with the disk you 
use lo begin with just incase you 
accidentally erase something you want. 

actually allet ihe disk, most just read off 
it. I have a copy of this program on every 
one of my disks, not because I wrote the 
prograjn, but because I find it 
indesfX-nsiblranrl i oulrin't do without it. 
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Calculate the buying power of any given sum of money for any year this century with this 
handy utility. 



Have you ever wondered if your 
wages, pocket money or pension 
have really kepi up with the cost of 
living? If you employ someone to do 
your gardening, or housework, are 
you sure you're keeping up their 
salary in real terms? Are recenl 
increases in your annual 
subscriptions to magazines, clubs etc 
really needed to keep up with prices? 

Certainly, everyone knows the 
current yearly increase in the Retail 
Price Index (RPI), buf calculating 
prices over a lonjii-r | >ei icirj i.- jnothei 



IAN DALZIEL 



matter, even if you know just where 
to get the figures. Have you any idea 
at all how much prices have 
increased in the last 10 years? Well, 
wonder no more, for "Price 
Calculator" will answer all your 
questions about price increases and 
the 'real value' of money, not only 
for the last 10 years but for any 
period this century. 

Perhaps you are a club treasurer 



and are preposing an increase in 
subscriptions, it will greatly increase 
your chances at the ACM if you can 
prove the increase is actually less 
than prices generally over the period. 
When someone tells you how cheap 
an item was in say 1960, you will be 

actually cheaper in real terms. 

If for example, you have a son or 
daughter that has just started work at 
a salary of 5,000 pounds per year, 
they will be able to compare it with 
the salary of their parents when they 



started work in 1965 but at 1990 
prices. You will be able to astound 
your friends with your newfound 
knowledge, and if you are a 
politician you will be able to prove 
anything with statistics! 

The program is very user friendly, 
all you need to do is to enter the 
price you know and the year 
applicable, then simply enter the 
year you wish to know the price of, 
for any year this century. The 
information used to perform the 
calculations was carefully researched 

calculations and the program has 
help screens to enable you to do so. 
You may also update the program as 
prices become known for future 
years and the program shows you 
how to do it. There are four worked 
examples in the help screens which 
will explain exactly what it is about. 
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WALKER AUENUE 


TROON , 


ft VRSH IRE, KA10 6SA 


PRESS 


I 


FOR INSTRUCTIONS 


PRESS 


u 


TO UPDATE THE INDEX 


PRESS 


T 


FOR TECHNICAL EXPLAHTION 


PRESS 


SPACE FOR THE PROGRAM 
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B.O.S.S. 



valueofx. The range is 0 to 15. 



MARC BANGS brings to you 23 new commands with his 
Basic Operating System Supplement. Developed with the 
C1 28's own Assembler 

After reading Burghard-Henry interpreter, only being updated while 
Lehmann's WjMw^n Extending Basic is being processed. This results 
in the clock stopping during an 



Com mod a r 



I derided u 
. Thes 



AT n,y - Changes the position of the 
cursor to x for row and y for column. 
EC: AT 12,15:PRINT"HI THERE" 
(Note the colon before the Print 
statement). 

ROM - Simply shows the Kernai 
release number of your machine 

POINTER on/off - Turns sprite 0 either 



developed using the bi 

Assembler on my C128. Because of OFF Is given. The advantage of this is 
the way this extension has been that the interrupt is left unused, i 
coded, it is a simple job to extend it can run some other backgrou 
with your own commands. Simply program, 
add your own commands at the end 
of the code and make the necessary 
branches/jumps. 



r off. , 



■upt I: 



* up, 




OLD - Recovers a newed program. 

OFF - Turns off the Basic extension. 

DISK - Defaults all I/O to disk. No 
secondary address may be passed 
whilst in operation. 

TAPE - As above, but defaults to tape. 

NORM - Returns to standard. Primary 
and Secondary addresses can be 



CLKON - Turns on the Basic clock 
The clock shows the current value oi 
TIS in the top right hand corner of the 
screen. The clock runs off the 



CLKOFF - Turns the clock off. 

HIRES - Turns on hi-resolution mode 

LORES - Cancels hires mode 

FILL - This changes the entire rolour 
memory oi the picture. The syntax is 
FILL x where x is a number in the 
range 0 to 255. The high nybble of 
this number is the paint colour, the 
low nybble the canvas. EG: FILL1 will 
give Black paint on a White canvas. 
Vou should always call FILL after 
using the HIRES command for the first 
time, otherwise pictures tend to 
appear st ram bled. 

(The last three commands came out 
of my use of DOODLE, but should be 
compatible with similar art packages). 



Basic INK x - Changes the character colour 



which enables the sprite to be moved 
with a joystick in Port 2. The sprite 
can be moved to any position on the 
screen but will not wrap perfectly. 
The sprite definition is controlled by 
location 2040 decimal. I have not 
included a default definition, this I 

imagination. 

PCOL x - Changes the colour of the 
pointer. (Note that the pointer is not 
as multi-colour). 

POS x,y - Enables you to set the 
pointer position from 0 to 344 in the 
x axis and 0 to 255 in the y. Any 
value for x above 255 is handled by 
the program, and the x coordinate bit 
is set or cleared automatically. The 
pointer is still under joystick control, 
and that this use of POS will not 
interfere with the normal Basic use. 

DEFAULT - This acts as if the 
following sequence had be entered, 
LORES:INK14:BORDER14:BACK6 

If none of the above commands are 
recognised, an error is returned by 
the B.O.S.S. and program execution, 
if any, is stopped. This is, in effect a 
syntax error with a different message. 
The 'SPA' in the message is an 
abbreviation for SPANNER, which 
just happens to be my computer 
handle. 

B.O.S.S. is entirely self contained 
in the present range of C000 to C700, 
which is 401 52 to 50944 decimal. 
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SCREEN 
DESIGNER 

Creating your own impressive screens gets another boost 
from this handy utility program. 



A WARRINER 



Ihe utility is made up a of a couple 
described. 

SCREEN COMPILER 
(address 52000-52775} 

Tint program copies the current lo-res 
screen being displayed and creates a 
chine code program 



e the 



1. The 



program automatically detects the 
video bank, screen address, character 
set poinler. colours ami niloiir mode 
being used and restores ihese values 
when the screen is re-created, 
impiled code 



- .idcir L - 



s fro 
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inclusive. To compile a screen, prinl 
the screen, then sys 520O0.AD: when? 
AD is the address at which the code is 
to be compiled, the program will 
return the end address of the code. lb 
re-create the screen simply enter sys 
AD. The screen data is not just stored 
as a block of data, but is compressed 
according In Ihe following method. 
The program searches from the start of 

character which is not a SPACE (#32) is 
round, this is the start of the screen. If 
then searches from ihe end of the 
screen, backwards, in the same way 
and marks this as the end of the screen. 

compressed and stored. When the 
screen is re-created the screen is 
cleared and ihe video |NM IMIHi II II are 
set.the data is then read and 
interpreted as follows:- 

If the dala value is less than 126 
then it is OR'ed with a variable 
(REVFLAG), which determines if 
reverse i irieo is nn or oil. and stored In 



if function 



the screen, the current colour variable 
(CURCOL) is stored in the 
corresponding ( olour memory. 

If Ihe data value is greater than 1 27 
then it is decipherer! ihus:- 

If bil 4 is set then bits 0 to 3 hold 
the new colour value (CURCOU 

If oil S is set then REVFLAG is 
flipped, i.e. reverse on becomes 

If bit 6 is set then there are a 
number of characters of the same value 
to be repeated, in which case, the nest 
data byte represents the number of 
characters to be done, and, the byte 
after thai holds the character value to 
be used. 

More than one bit may be set at a 

If bits 0 - 6 are zero then this is the 
last byte and the routine exits 

The program "compiler 52000" on 
Ihe disk is a basic loader for "compiler 
rode", which is the program itself 

SCREEN 

DESIGNER/COMPILER 

(address 16384-28374) 

design and compile screens. 

When the program starts you are 
presented with the main menu from 
which you may select an option by, 
moving up or down the menu with 
the cursor keys, or, by typing the 
initial letter of the option, the options 
are as follows:- 

DESIGN SCREEN 

characters and change roll 



CTRL+F1 - Enter block mode. 
In block mode you must follow the 
following sequence. 
Move cursor to upper left corner of 
block and press RETURN. 
Move cursor to lower right corner of 
block and press RETURN. 
The block is now defined and may 
be moved around the screen with the 
cursor keys, in addilion:- 
RETURN - will printthe block. 
Any COLOUR key will fill the block 
with that colour. 

F7 - reverses all of the 

haracters in the 



blot 



RUNSTOP - 



em 



will prinl the block 
clears the block and 



Continuing function key definilio 
F3 - Insert a blank line 



nup tc 



F4 

CTRL+F3 - 
LOGO+F3 - 



CTRL+F5 - Increment border 
(5HIFT+CTRL+F5 



screen and border) 
LOGO+F5 - Switch cursor off, any 



F7 



Reverse off. 



FB - Switch Forrerolour/ 

■ Copycolour mode. 
Forcerolour is the normal typing 
mode in which the character printed 

copycolour mode the rhararter is the 
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colour of the existing character on 
the screen, unless, that colour is the 
background colour in which case the 
last, selected, colour is used. 
CTRL+F7 - Paint with cursor 

In this mode as the cursor moves 

characters it moves over, any key, 
other than ihe cursor keys, exits this 

IOGO+F7 - Draw wilh current 

character. 
In this mode the character which is 
under the cursor when the mode is 
selected is printed as the cursor moves 

determined by Forcecolour/ 
Copycolour. 

To exit the designer press RUNSTOP to 
return to the main menu, or, 
SHIFT+RUNSTOP to call up HELP 



HELP 

This will call up the designer help 
screens. RUNSTOP returns 10 main 
menu any other key calls second help 



VIDEO PARAMETERS 

On this screen you may select the 
video bank, screen address, character 
set pointer, colour mode and colours 
used by the designer and compiled 
code. You may also view the selected 
character set. Certain addresses are 
not available as they are used by the 
program. RUN5TOP to return to main 




COMPILE SCREEN 

On this screen you will be prompted to 
enter the address at which you want 
the designer screen code to be 
compiled, if you have previously 
compiled a screen you will be 
informed of the next available address 
to allow you to create consecutive 
blocks of code, pressing RETURN 
without entering anything will 
au to ma l i rally compile at Ihis address. 
You will not be allowed to compile 
code which overwriles Ihe program, 
this is not a problem as you can 
compile the code lo a different address 
and then use the seperate screen 
compiler to move it to your desired 
location. Once code is compiled von 
have the option to save the code in 
which esse you will be prompted for a 
filename. Code may be compiled and 
recalled from under the I/O area and 



under Ihe Roms, but. (inly code under 
ihe Basic Rom (41N60-491 511 may be 
saved. The program uses the area 
under the Kernal Rom (57344-65535) 
as a workspace and so any code 
compiled there may be comipled. 

RECALL SCREEN 

This allows you to put a previously 
compiled screen into the designer, 
also, all of the video parameters are 
read from this code. Il no code is found 
al Ihe address you spec ify then you will 
be asked if you wish to search for 
code, it you do ihen the program will 
search from that address until valid 
compiler code is found which is then 
loaded into Ihe designer, you may then 
exit or continue to search. 

LOAD/DIRECTORY 

St'lectins; this djjIhifi .iIImws you to view 
the disk directory and load from it. You 
are not allowed lo load code whose 
slarl address is in the program memory 
space. When code is loaded the load 
start and end addresse- .ire dkplaved 
and, if (he code is a compiler screen it 
is loaded into the designer and a red 
asterisk (") is displayed to inform you 

I- i- |-|,LM|JL-.'|1U<! 

QUIT 

liese! computer. Re Miter pmur.im with 

sys 16384. 

The program "Screen Designer" [2049- 
3014) on the disk is a basic loader and 
loading screen for the main program 

"scad". 
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A guide to scrolling 



Firs! and foremost lei me just point 
out one thing. On some older C64's, 
the colour memory may need lo be 
set each time the routine is called, by 
POKEing to it. (55296-56295). On 

ir by POKEing 
rick. Note that this 
is only if the routine does not at first 
appear to work. 

One of the first questions budding 
young programmers ask is,' 'How do 



646,n v, 



indeed? First, the scrolling must be 
done from machine code as Basic is 
too slow to avoid screen flicker. 
Scrolling uses special hardware 
provided by the VIC chip. In 
essence, all that is needed is to 
update a 3 bit (0-7) counter, and let 
the VIC chip dc 



landscapes on the Commodore 64 for beginners. 

screen is made to be in multicolour 
mode, and the multicolour changed 
constantly. So if the colour memory 
contains colours from 8-15 the 
characters with that colour 
assignment will appear to glitter as 
= i™ j l° U T U5 ' SE1 bk 3 ° f ,hE mulli( olour changes. The routine 
53270 and the y-direction is bit 3 of does not actually update the colour 
53365. One of the most common memory, so it is advisable only to 
uses of scrolling is in providing a use one colour on the screen. Before 
landscape for a spaceship etc in a you try to use the landscape routine, 
game. This is most commonly done you should POKE the colour memory 
""ings for your 



EDMUND DUMBILL 

Tolling is ruined as large gaps mot 
ack and fonh at the side of th 
:reen. To shrink the screen in the > 



m the 



ive the characters 
different screen 
but it shifts the 



Si 

LEFT A BIT, RIGHT A 
BIT, DOWN A BIT... 
SCROLL 

39 



. (Sei 



-t of 



memory locat 

whole of the screen several pixels to 
the left/right up/down. There are in 
fact 2 scroll counters, x-direction 
(horizontal) and y-direction (vertical). 
To gain the left effect as opposed to 
the right effect, you must decrement 
the 3 bit counter, and vice versa to 
go right. The process is the same for 
the y-direction. To move characters 
on/off the screen, a simple piece of 
machine code is needed, which 
copies every character on the screen 
either one character to the left/right 
up/down. So now we know basically 
how scrolling is done, you may be 
asking the question; where is all the 
mythical registers? A quick 
consultation of the users guide will 
assist you. The y-direction is bits 0-2 
of location 53265 and the *- 
direction is bits 0-2 of location 
53270. To achieve neat scrolling you 
must 'shrink' the screen so you can 
hide the characters you are putting 
onto the screen in the border. If you 
don't do this the whole effect of 

20 



decrementing the 3 bit counter 
53270. I will now give a program 
breakdown of a landscape scrolling 



HOW THE ROUTINE 
WORKS 

I shall not go into detail as to how 
the interrupt routine works, as it does 
not pertain particulary to scrolling 
(Eric Doyle wrote a series of interrupt 
articles in your commodore in 1988- 
1989). Every 50th of a second, the 
scroll routine is called. On being 
called, it decrements the speed 
counter and then scrolls one pixel to 
the left. The state of the scroll 3 bit 
counter at 53270 is actually stored 
separately in JC0FF. It is checked if 
the scroll counter has reached pern 



THE ROUTINE 

The routine is a very simple une, 

providing a landscape 256 characters if so, it is time to shift the screen one 

long by 11 lines deep. The landscape character to the left, and to reset the 

is actually interrupt driven, so your scroll counter. If you did this in 

program can be getting on with its Basic, you would be able to see the 

own business while the landscape apparent spectacle of the whole 

scrolls along. Another aspect of screen shifting back 8 pixels, and 

interrupts is also brought in; the split then shifting back 8 pixels again with 

screen. As the landscape is only II the new screen data. Obviously 

lines deep, we want the other 14 machine code is too fast for the eye 

lines to stay still, so the screen is split to see what is going on. The process 

at the 12th line. As a novelty, I have of updating the 3 bit counter is 

u, \J va(i , able s P eed of continued for as long as the speed 

scrolling. This is achieved by instead counter says. The speed counter is 

of scrolling the screen 1 pixel every located at SCOFD, Shifting the whole 

50th ot a second, scrolling the screen screen one character to the left is a 

by any amount stored in a memory laborious job. of which there are two 

location. The number in this location ways of going about it. The first way 

consequently becomes the speed is the way I've used, which Is to shift 

number. As a further novelty, the one row at a time with seperate 



commands and then to shift the new 
data in from $CJ00 onwards. This is 
rather a long winded way, and a 
better way, but more complicated, 
would be to use extensive indirect 
addressing to shift all data in and 
nut. The advantage of a lung winded 
way is that it is often the faster way, 
as in this case. There is a pointer 
which keeps track of where the 
computer is along the landscape. 
This counter is located at SCOFE, and 
is decremented every time the screen 
is shifted one character to the left. A 
few pointers are used from SC200- 
SC206- You can try altering them if 
you want, $C201-$C202 control 
border colour around and below the 
landscape, and SC203-$C204 the 
streen colour SC205-SC206 control 
the position of the town sol I You 
can try stiNtting iht- screen at 
different ulaces to alto the scroll, but 
mnmbei thM the ■■hirt routine does 



TO USE THE ROUTINE 

The landscape data used by the 
computer is at SC300 and ends at 
SCDFF. The data is stored as screen 
codes not as A5CII data. There is no 
easy way to POKE in your landscape 

ft 

TRY SPLITTING THE 

SCREEN AT 
DIFFERENT PLACES 
FOR GOOD EFFECTS 
» 

data, apart from to write a landscape 
designer program. It is probably best 
to use a character set that you have 
defined especially for ihe landscape, 
but I have designed a landscape that 
uses ihe default i kir.icter set. To start 



the landscape going simply select it 
from the CDU menu or alternatively 
load it independantly and type 
SYS49152. For Ihe more inquisitive 
amongst you the following is a 
breakdown of the main program 

$C000-$C025 - Setup variables and 
interrupt pointers 

$C026-$C065 - Main interrupt 
handling routine. Deals with split 
screen and border colours. 
JC070-SC07F ■ Decides whether the 
landscape routine should be called, 
and calls it if needed. 
SCOBA-5C15F - Shift screen one 
character to the left routine. 
Interposed with variables as already 
mentioned. 

SC160-JC187-Main scroll routine. 

I hope this short introduction into the 
art of scrolling will prove to be of 
some benefit to you. Especially to the 
novices out there in C64 land. 



corrupted). 

To restore screen contents after a 
window is finished with enter the 
command - WINDOW* - this will 
remove the last window opened and 
decrease the window counter. 

There is another useful feature of 
this program. After opening a 
window it can be bordered and 
shadowed. Use the command 
SYS5696,<border colour>,<shadow 
colour;-. This will place a border 

shadow it. The colours are from 0 to 
15. 

One small point to note is that 
your variable space is reduced to 
about 40K. This should not cause 
any problems, but be careful not to 
go overboard with enormous arrays. 
The program also uses zero page 
250-255 ($FA - SFF) addresses. To 
see the wedge in action LOAD and 
RUN the program 'Window demo' 
after BLOADING WINDOWS. One 
last point worth mentioning. 
ALWAYS home Ihe cursor after 
opening a new window, otherwise 
strange things have been known to 
occur tbut very rarely). 



WINDOWS 128 

Storing and recalling windows is simplicity itself with this 
handy C1 28 routine. 



While designing a short progr; 
my C128, I decided to use some 
windows to make the display more 
attractive. Then I remembered him 
Commodore had 'Forgotten' to 
include any window saving routines 
in ihe Basic. Thus, I resolved in write 
this 



a variable} and install the wedge. 
Enter this; SYS53B1:CLR This will 
also reset the windows stored to 
So any windows previously 



vedge which would record the opened 

n contents, (including colour), to place this at the begining of your 



s reached. Also w 



land programs. The rt 



)uld 



D the 
e the a 



to clear the variable 



a W'hich has 



it window and 
recall the old screen. Up to 9 
windows can be opened 11 0 
including ihe original screen). 

So, how do you use the routine? 
First of all you will need to load in 
the wedge by BLOAD"WINDOWS" 
<return>. That will load the routines 



i which been moved lo make room for the 



hich will be stored in 
BANK 1 underneath them. Now 
WINDOWS will be installed until the 
machine is reset, (after a reset, using 
the above SYS call should re-inslall 
WINDOWS without re-loading). 

The WINDOW command 
operates as normal, except only 9 
memory from $1400 to SI7FF may be used in a row. Any more and 
you should memory is filled up resulting in a 
being generated (as 
■ variables being 



s into both RAM 



banks (To avoid crashes when using oppoi 
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ON THE DISK 



SAMPLE KIT 




b compliment last months program 'Sequencer 64' by Steve Carrie, I present a sample 
program of my own creation 



finally 
of the 



The SAMPLE KIT 64 
designed lor use by 
excellent digital souni 
Datel Electrons 
those without the sampler hardware, 
can have hours of fun by using this 
kit, with the accompanying 
demonstration sound sample, and in 



ttepro 



indie 



n of 



THE KIT IN USE 

The kit enables a sound sample to be 
'chopped' info individual parts, 
known as the 5AM PL E SPLITS; these 
'sounds' can then be linked lu);elher 
in a sequence, known Ihroii^houl ,is 
the TUNE. Edited tunes can be saved 
to disk, and data created can be used 
to playback the tunes within your 
own programs. To aid in this I have 
included a source file named 
SAMPLEPL AVER. ASM, which can be 
assembled by the MIKRO .sssumbler, 
and CDU's very own 6510+. 



sample file, which is created with 
Datel Electronics "Sampler 64" 
software/hardware package. The kit 
requires you lo save the sample data 
from Datel's utility as a full 32K file. 
This is a save range of 0-8, (a sample 
split of 1 ); see the sound sampler 
instructions manual for more details 
of setting the sample save range. 
Other sound sampler data files may 
be compatible with the kif, but I have 
only had chance to use Datel's unit. 
So, if you have another sampler, why 



not try ,1 
By usin 



a full 



to the final tune. 

SAMPLE KIT EDITOR 
SCREEN 

The screen display is split into twi 
main areas. The top of the screei 
comprises of the SPLIT METER, this i 
the display on which the sampli 



splits are tested, and created. The 
area below is the CONTROL PANEL, 
coming complete with a selection of 
'function buttons'. 

ACTIVE MODES 

Whilst on the editor screen, you can 
be in one of two modes of operation, 
each is denoted by a particular 
i ukmred border:- 

BLACK border - control refers lo the 
CONTROL PANEL (lower region of 

BLUE border - control refers to the 
SPLIT METER (upper screen region!. 
To toggle between the two modes 
press the SPACE BAR. 

CONTROL PANEL MODE 

The 'function buttons' arc operated 
by positioning a pointer over the 

made by pressing fire. All control is 
via a joystick in port 2. The available 
function buttons are; 

1 - Increase step in tune (CRSR up 

key - optional]. 

2 - Play tune - press space to 
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TUNE FORMAT 






A typical TUNE 


on Id be of the following form: 






CommanoVSplit 


3 play Re peat/para me! er 


Step 


<;Commenl> 


SP 


03 








05 


01 


Delay 05 . 


00 


01 




Play sample 








split 00 once 


02 




03 


Play split 








02 16 times 


BLANK 


00 


04 


Exits 



3 - Decrease step in tune (CRSR 

dawn key - optional], 

4 - Select area in tune window to 

edit. 

5 - Increase parameter of selected 

item I; key optional). 

6 - Decrease parameter of 

selected item (= key optional). 

7 - Delete highlighted step in 

8 - Insert before highlighted step 

9 - Exit to hie menu. 

Note that keeping the space b 
depressed (toggling between the n 
modes of operation), and at the sar 
time pressing the lire button, slo' 
down the effect of a selection. Tl 
can be useful if you seem to ra 
through values, and require a 'fir 
resolution' when selecting, 

SPLIT METER MODE 

The two sample split indicators, 
appearing on the meter display 
(white=start split; red=end splili, can 
he moved by using the joystick in the 

each indicator respectively. In effect, 

complete sample- inlo 126 different 
sounds (shown as hexadecimal 00- 
7F), To select a particular split to 
edit, use the Fl and F2 keys. Press 
fire to test the sound split, and once 
the sound is as you require, store the 
information by pressing F7. Note that 
without pressing F7, no new sample 
split information will be slored. The 
border will rapidly flash colour to 
n that data for the sample split 



only, the speed of the playback can 
be changed by pressing the FJ and 
F4 keys. The speeds can range from 
S00-SFF (0-255], and is the delay 
between the processing of bits when 
playing back a sample. Note that a 
speed of 0 gives the largest delay, 
being equivilant of 256, The sound 
quality heard in this test mode will 



suffice 



•i purposes 



TUNE FORMAT 

The tunes are displayed in the TUNE 
WINDOW, this is the area to the 
right of the first block of function 
buttons. Each step shown in the 
TUNE WINDOW comprises of; XX 
YV ZZ; where XX relates to either a 
value in the range S00-$FF, this 
being the sample split number to 
play, OR a command:- SP=select 
speed to play subsequent sample 
splits; WT=cause a specified delay 
before the next step in the tune is 
processed; RE=command to restart 
the tune. A blank space in this area 
signifies the end of the tune. The 
hcvidecimal v.-iluf referred to by YY 
can be either Ihe number ol repeats 
of a sample (if a value S0O-J7F is 
specified), or a parameter value to be 
used with one of the 5P/WT 
commands. Note that both the 
command RE, and a blank space, do 
not lake Ihe value of YY into 
account. To make either XX or YY as 
the field to be edited, select the *< 



or 'YY' field. When this appears, 
selecting the "+" and *-* function 
buttons will increase or decrease Ihe 
field value. The value ZZ is the step 
number in the tune. 

DEMONSTRATION FILES 

I have supplied a Menu initiation lilt;. 

relevant sound samples are suffixed 
with ".SAM", tune information with 
".TUN", and split information with 
".SPL ". To listen to the demonstration 
file, named MISC, enter FILE menu 
selecting the FILE function button 
when you wish to load and save 
data. From the FILE menu; 
select option "LOAD SAMPLE FILE" - 
enter name as "MISC.SAM". select 
option "LOAD SPLIT DATA" - enter 
name as "MISCSPl", select option 
"LOAD TUNE DATA" - enter name 
as "MISC.TUN". When you have 
loaded in the required sets of data, 
select the play function button on the 
control panel to listen to the demo. 

PLAYING A TUNE IN YOUR 
OWN PROGRAMS 

Enter the file menu by selecting the 
FILE button on the editor screen. You 
will need to save the SAMPLE SPLIT 
DATA, this contains the start and end 
addresses for all of the 1 28 sample 
splits. Also, a TUNE DATA file is 
required, this contains all the 
necessary control codes for speed, 
delay timings, and a sequence of 
sample splits to play. Most notably, a 
copy of the sample file is required to 
re-play the tune. The quality of 
sound reproduction is greatly 
improved by disabling the screen (by 
clearing BIT 4 of location JD011). To 
add to this effect, the interrupts are 
also disabled with SEI throughout the 
playing of the tune. Please refer to 
the source file (SAMPLEPLAYER, 
ASM) for some documentation on 
memory usage and handling of the 
tune/sample split data. 

Finally, even if you haven't obtained 



iounri s 



nplei 



'■ kinct 



In*-, been saved. For I 



i purpose 



sample your own sounds, I hope you 
enjoy playing around with the kit - 
hopefully not annoying anybody in 
the process so turn up the volume! 
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FEATURE 

1581 Internal 

Disk 
Commands 

Getting to grips with the 1581 disk drive is explained in an easy to understand manner. 



PAUL TRAYNOR 



1581 Memory 




The memory can be split info ihe? following areas; 


$0000-$1FFF (#0-#8191) 


RAM, which can be split into the following; 


$0000-$OOFF (#0-#25S) 


Zi-ni page, job qu(.;u«, variables. 




The zero page contains many of the important parameters which are required by 




DOS. The job queue enables the the controller and DOS to communicate with 






S01OO-$O1FF(#256-#51l) 


Stack, variable?, vectors. 


disable 


The RAM vector addresses found here are the ones which can be altered to 


commands such as scratch or the new command 


S0200-S02FF (#512-#7671 


Command buffer, tables, variables. 


S0300-S03FF (#768-#1023) 


Data buffer 0 


5O4OO-S04FF (#1 024-#1 279) 


Data buffer 1 


S05OO-S05FF (#12B0-#1535) 


Data buffer 2 




Data buffer 2 is the one where the user commands u3-u8 (or uc-uh) will jump to. 


S0600-J06FF (#1 536-#1 791 ) 


Data buffer 3 


$O7O0-$07FF (#1792 -#2047) 


Data buffer 4 


$0800-$08FF (#2048-#2303) 


Data buffer 5 


S0900-S09FF (#2304-#25S9t 


Data buffer 6 


SOAOD-$0AFF (#2560-#2Bl 5) 


SAM for first 40 tracks 


SDBOO-SOBFF (#2816-#3071l 


BAM for last 40 tracks 


$OCO0-$IFFF(#3O72-#B191| 


Track Cache Buffer 




The track cache buffer helps to increase the speed of input/output operations. This 




is because all access involves whole physical tracks which are stored in the track 




cache buffer. If more than one sector is to be read and they are all on the same 




track then only one disk access will be performed, further sectors will be read 




from the track cache buffer, 


$4000-i5FFF U1b384-#24575 


Serial Bus I/O 




I/O is controlled by a 8520A CIA chip 


S6000-S7FFF (#24576-#32767) 


Floppy Disk Controller (FDC) 




The FDC is a Western Digital 1 770 or more recentlyl 772 


$8000-$F£FF (#32768-#65279) 


32K ROM, DOS and controller routines 


SFFOtVJFFFf (#652B0-#65535) 


Jump table, vectors 
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The Internal Disk Commands allow 
the user to manipulate the memory 
of the disk drive. It is also possible to 
run machine language programs in 
the memory of the drive. As with 
Direct Access Commands care must 

commands, especially ii the user has 
no or very little experience. 



GENERAL RULES 

When you are first using Internal 
Disk Commands you must be aware 
that any error in programming can 
lead to the drive hanging up, and the 



,nly v 



rol i 



h off and the 
programming error has lead to the 
drive motor and green light 
remaining on. then the only way to 
safely regain control tie. avoiding 
corrupting datal would be to reset 
the computer. Therefore I advise that 
you should save all programs before 
running them. 



COMMANDS 

Memory Read 

Wild the memory read comm. 
you can access any of the addre? 
within the disk drive's memc 



equiv 



: of the BASIC PEEK 



90 seW1S,s$:if\S="" 

x$=chr$(0) 
100 print asc(xS); 



example program when run i 
determine the type of disk drive, 
device number (x) to be lifter! i- 



10 x=9 

20 openl5,x,15 

30 openl,x,8,"#1" 

40 prinrri ,"m-r"chr$H 98ichrS 

(229)chr$(l ) 
50 getffl ,a$ 

60 if asc(aS1=0 then rjr$"*t581": 

elsedrS="1571/41" 
70 closel 
SO closel 5 
90 printdrj 

IS 

EXERCISE CARE 
WHEN USING DOS 
COMMANDS. 
I) 



progr 


m will put a machine language 


rout in 


e into data buffer 2. Operation 


Of ill 


routine is explained later in 


i-.- :. 




10 


0pen15,9,15 


20 


y=0 


30 


read x:if x=256 then end 


40 


prints! 5,"m-w"chr$IO+y)chr$ 




(5)thr$(1)chrS(x); 


50 


y=y+1 


M 


goto30 


70 


data 76,7,5,32,229,129,96, 








240,252,96,256 



Memory Execute 

With the memory-execute commani 
you can execute any routine in drivi 
memory RAM or ROM. Memor 
Execute is the drive's equival 
the BASIC 5YS command, th 
i niv.m.iml rrinn.il is shown below. 



of 



print#15,''m-e''crlr$<l)chrS(h> 
where: l=memciry address low order 
h=iriemory address high < irrler 

command at work, load and run the 
memory-write example program, 
(note that channel#15 should still be 
open), and then enter the following 
command in direct mode. 

print#1 S."m-e"chrS(0lchr$l5) 



print#15,"m-r"chr$(l)chr$[h)chr$(n> 
where; l=memory address low order 

h=memory address high order 

n= number of bytes 

The first example program will 
read any address of disk memory and 
up to 255 bytes at one time. The 
address should be entered in decimal 

10 open 15,9,15 

20 input"! down] number of bytes 

to read (0=finish)";n 
30 if rxl then close 1 5:end 
40 if n>255 then 20 
50 input "starting at address";ad 
60 h=int(ad/256);l=ad-h*256 
70 printtl 5,"m-r"chri(l)chrS(h) 
chrS(n) 



within the disk drive's o 
Memory-write is the 
equivalent of the BASIC POKE 
command, the command format is 
shown below. 

print#15,~m-w"chr$tlichr$(h)chr$ 
(n)chr$(d11chrS(d2)....chr$(dn) 
where; l=memory address low order 

h=memory address high order 

n= number of bytes 

dl-dn=data bytes 



switch it off. 

print#l 5,"m-e"chrJ(3)chr$!5) 



You 
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program in the sector will be read 
into the buffer and then executed. 



prinl#15,"b-e:";channel#;drive#; 
lrackff;sector* 

print* 1 5, "b-e :channel#, drive*, 
track#,sector#" 
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FEATURE 



A programming example of the 
block -execute command is shown in 
the 1 581 user's guide. 



USER COMMANDS 

User commands tell (he 1 581 to 
execute programs starting at certain 
predefined localions or addresses in 
it's memory. Below is a table of user 

functions. 



User 


Function 


Command 




uO 


Restores default 




user jump table 




Equivalent of direct 
access command 




Block-Read 


u2 orub 


Equivalent of direct 
access command 


u3 or uc 


Block- Write 
lump to RAM data 




buffer #2, Location 




$0500 (#1280) 




Jump to RAM data 




buffer #2, Location 




$0501 (#1283) 


u5 orue 


lump to RAM data 




buffer #2, Location 




$0506 (#1286) 




lump to RAM data 




buffer #2, Location 




$0509 (#1289) 




lump to RAM data 




buffer #2, Location 




$050C (#1292) 


u8oruh 


lump to RAM data 








S050F (#12951 


u9 or ui 


lump to the reset 




tables, Location 




$FFFA (#65530) 




Power up vector 



The format for sending a user 
command is as follows; 



print#15, "ucharacter"; 

The character is taken from the 
above table. 

Although there is only space for 
three bytes between each of the u 



localions. This is sufficient room for a 
machine language IMP command 
allowing you to use longer routines 
that can be initially called up by 'u' 
commands. To show an example of 
the user commands at win k load and 
run the memory-write example 
program, (note (hal channel#15 
should still be open), you will notice 
that m-w example program loads the 
program Into data bllffet#2 which is 
the one where the user commands, 
u3-u8 (uc-uh). jump to therefore this 
program can be operated by user 
commands as well as the 'memory- 
execute' method previously shown. 
When you have run the 'm-w' 
example program enter the following 
command in direct mode. 

prinl#15,"u3" 

This first command will switch 
the drive activity light on. 

This next command will then 
switch it off. 

print#15,"u4" 



UTILITY LOADER 

The utility loader is the command 
which will load J USR lilt from disk 
inlo disk drive memory where it will 
then execute. The format for the 
ulililv loader i ommand is as follows: 

print#15,"&0:filename" 



USER FILES 

A user file has to follow certain 
guidelines. It is limited to just one 
sector of a disk and this sector is 
constructed as below; 

Byte 

0 Start address low order 

1 Start address high order 

2 Number of program 
J- Program code bytes 
last checksum 

program code bytes is 251. The 
checksum byte will immediately 
fallow the last program byte. The 
checksum is calculated by adding all 



the values of (he byies, starting at the 
low order start address (byte 0) 
, while adding you round down to 
zero every time you reach 255. 

A method of creating user files is 

sequential file (except using ,u,w 
instead of ,s,w) and then read into 

example, the values of all the bytes 

framework for a program which will 
create a user file on disk which can 
then be subsequently executed by 
the utility loader command. 



10 


open2.9,2,"0;&filename,u,w' 


20 


read d :if d=256 ihen 40 


30 


prints:. 


hr$(d); :goto 20 


40 


close2:end 


50 


data 1 








low order 


60 


data h 


:rem start address 








70 


datan 








program bytes 








90 




:rem program code 


100 






110 




:rem checksum 


120 


data 256 


:rem program data 









AUTO BOOT LOADER 

When any ol the following functions 
are performed; power up, reset, burst 
inquire, hursl queryor (he initialize 

■'copvrisht dim 86", if present, will be 
loaded into disk memory and 
executed. After executing (he program 
must call the JCBMBOOTRTN to 
return control to the drive, there are 
three methods of disabling the 
automatic loading of this file; 

Setting a flag in the BAM, Byte 7 
track 40 sector 1 (there is also a copy 
in byte 7 track 40 sector 21 

Setting a flag in drive RAM, The 
JDEJAVU jump table vector 
mentioned in the user's guide is at 
location $ff60 (#65376) and (hal uses 
the SWITCHAUTO at location $9145 
(#37189) ' 

The third melhod of dis.ililinj; the 
auto boot loader is the simplest and 
thai is to jus! rename the file. 
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ADVENTURING 



ADVENTURE HELPLINE 

JASON FINCH Continues his aid to those Adventurers stuck in the middle of 'KRON' 



Welcome once again io Adventure 
Helpline. The pasl three issues worth 
have concerned themselves with 

written by Tuny Home and published 
by CDU in December 1 989. 

However, although a solution was 
given to each problem, the help 
provided was of a very cryptic nature 
and not everything was revealed 

(includin/this one) will virtually 
duplicate the motions at the first 
Ihree but this time each Of the fifty- 
four locations will be described in 
detail and the commands given that 
you should type in each location to 
successfully complete ihe adventure. 
Not only that, but the results of your 

all exits and where they lead. I am 
not going to tell you which ones to 
take until the end because they will 
he different if a location is visited 
twice, once on going somewhere 
and again on returning from that 
other location. I shall, however, 
inform you of directions that you 
should not take. Suffice it to say that 
following these and the broad 
directions given in the other three 
anicles you can't go far wrong. Each 
location has been given a number, 
the first being, quite obviously, 
number one. The layout is quilt; sell- 
explanatory but for the first location I 
have provided details of what you 
need to know. And in ibis issue slage 
one, the first twenty-thru^ luc.il ions, 
will be recreated for you. Lei the 
story begin... 

1. At Ihe Lagoon of Stars, Rocks 
surround the beach while to the easl 
strelches the dreaded Sea of Storms, 
(this is the main description of the 
location exactly how it is worded on 

Exits: EAST 2 (this means that by 
using the verb east' you travel lu the 



location numbered two in this series. 
These exits are not necessarily the 
only ones because new ones can be 
discovered by performing various 
operations] 

Type: EXAMINE ROCKS - boat 
appears (only type what is given in 

represents the results of Ihe action. 
This text should only be used on the 
first entrance to the location. Upon 
returning just go where you see fit. 
There may he. like in this case, more 
than one line of lent, so type the first 
followed by the second and third and 

GET BOAT 

It 

ALL THE NICE GIRLS 
LOVE A SAILOR 

n 

2. On the Sea of Storms east of a 
cove. The waves scream like angry 
vultures waiting to devour their prey 
as they rise and fall in a tortuous 
rhythm. 

Exits: WEST 1 

Type: HOIST SAILS - allows south 
and east movement (to 8 and 3 
respectively) 

Other info: Do not drop the boat 
at any stage when you are in the 

mercilessly against the small boat. 
Exits: EAST 4, SOUTH 9, WEST 2 

4. In open sea. To the south is a 
sound of rushing water. 

Exits: EAST 5, SOUTH 10, WEST 

3 

Other info: Do not go south 

5. On the northeast coast of Sark. To 



the west is the sea. An old monastery 
stands on a did overlooking the sty. 
The moon moves behind the dark 

gloomy sky. 

Exits: WEST 4 

Type: WAIT - moonlight reveals 

Other Info: If you have just 
uncovered the steps, go up them. If 
coming down, remember to pick 
your hoal up again as it will have 
been left at ihe bottom of the cliff. 

6. In open sea east of a treacherous 
rocky inlet off the northwest coast of 
Sark. To the south shroudetl by misl 
is a strange rock. East is open sea. 
Exits: EAST 7. SOUTH 12, WE5T 

^ Other info: You may here cries 

elsewhere in the adventure. 

Exits: EAST 8. SOUTH 13, WEST 



8. The sea stretches in all directions 
and bearing south is a tiny island. 

Exits: NORTH 2, EAST 9, SOUTH 
14, WEST 7 

9. In open sea there is a sound of 
rushing water to the east. 

Exits: NORTH 3, EAST 10, 
SOUTH 15, WEST 8 

Other info: The sound of rushing 
water to the east is in fact a deadly 
whirlpool. Under no circumstances 

death. 

10. The boat is caught in a deadly 
whirlpool! You are slowly sucked 

escape... 
Exits: none 

Other info: This location 
represents certain death. Entering 
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here results in you being killed 
without a chance to escape. Do not 
enter this location. 

11. In an old Bo ran monastery which 

biMuliuil stained glass windows are 
now either cracked or broken. Steps 
lead down to the shore. 
Exits: DOWN 5 

Type: EXAMINE RUINS - a scroll 

PP TAKE SCROLL 
Other info: The only way to go is 
back down the cliff. When at the 
bottom remember to take your boat 
again or else you will drown. 

12. On (he Rock of Akron. A 
greenish mist surrounds you and 
voice:-, whisper your name... or is it 
just the sound of the wind hurrying 
across the sea... , 

Exits: EA5T 13, NORTH 6 
Type: LISTEN - sound comes from 
a clam 

OPEN CLAM - this can only be 
done if you are holding the bar 
which is found in location 16. On 
opening the clam you find an old 
lamp. 

TAKE LAMP 

Exits? NORTH 7, EAST 14, 
SOUTH 18, WEST 12 

14. On Refuge Rock a small island 
totally surrounded by the Sea of 
Storms. A small cave covered with 
twigs is almost hidden from view 

Exits: NORTH 8, EAST 15, 
SOUTH 19. WEST 13, ENTER 22 

Type: GET TWIGS 

Other info: If here for the first 
lime, enter the cave by simplv ivping 
ENTER CAVE 

Exits: NORTH 9, EAST 15, 
SOUTH 20, WEST 14 

16. On the northwest coast of Sark. 
The rocks here are jagged and slippy 
under foot. An old withered tree 
stands on a ledge a few feet above. 

Exits: EAST 6, CLIMB 17 (see 
below] 



Type: GET BAR 

THROW ROPE - found in 
location 22. The rope will wrap 
around the tree 

DROP BOAT - otherwise the 
branch will snap 

CLIMB 

It 

WHO WANTS TO LUG 
A HEFTY BOAT 
AROUND? 
» 

17. On a ledge above the rocks. A 

branches cracked and dry. In the 
distance is the Castle of Spells 
towering againsl the skyline. 
Exits: DOWN 16 

Type: RELEASE EAGLE - it flies 
away but leaves a flute 
GET FLUTE 

GET BRANCH - this will be 
needed to provide light later on 
DOWN 

18. Al a rocky inlet on the north 
shore of Sark. Cliffs tower above the 
waterline... A lone figure stands on 
the clifftop! 

Exits: NORTH 13 

19. Off the north shore of Sark. 
Ahead are the Caves of Goth. It is 
rumoured that anyone who enters 
them never returns to tell the tale... 

Exits: NORTH 14, SOUTH 23 

20. In the Valley of the Storms, a 
narrow water-way cut through solid 

as your boat approaches. To the 
north is open sea and south lies fhe 
land you remember so well... Sark! 
Exits: NORTH 15. SOUTH 21 
Other info: If you go south from 
here then you will meet up with 
death. Do not enter location 21. 

21. In a waterway in the Valley of the 
Stones. Suddenly huge rocks fall 
from the steep slopes!... They smash 
your frail boat into small pieces... 



Exits: none 

Other info: Like location ten. this 
location represents certain death. 
There is no escape from the rocks 
that fall on you. You will be crushed 

22. Inside a small cave on Refuge 
Rock. This was once a resting place 
for Pilgrims crossing the Sea of 
Storms. 

Exits: OUT 1 4 
Type: GET ROPE 
OUT 

23. On the north shore of Sark north 
of the great Caves of Goth, an 
underground maze of tunnels and 
pits. Somewhere in the depths of this 
subterranean world is the Cave of Ice 
said to hold the key of freedom. 

Exits: NORTH 19, SOUTH 24 
(covered next month!) 

Well that just about wraps up the first 
stage in detailed terms. To best solve 
this part you should follow closely the 
lolluvvmj; location motions (eg: 1-4-3- 
2-5 means start in location one, move 
lo loc ation four and (lit whatever you 
are instructed in these instructions, 
then go to three and do whatever you 
must do there, then to two, and so on I. 
One of the "correct" methods is as 
follows: 1 -2-3-4-5-11 -5-4-3-2-8-1 4- 
22-14-8-7-6- 16-17-1 6-6-1 2-1 3-14-1 9- 
23. 

If you follow the movements and 
do exactly what I have said in each 
location you should find it possible to 
move between the locations lhat I have 
illustrated and in that order. Just 
remember NEVER to enter locations 1 0 
or 21 as these will result in you having 
to start over again. Also, there are 
twelve locations that represent times 
when you are in your boat on the 
walen. of the Sea of Slorms. Never type 
DROP BOAT or anything to that effect 
or you will drown and remember that 
unless you find land you will die from 
exposure if you slay in the sea for loo 
long (about thirty moves). Next month 
we shall have a look at the next 
seventeen locations which will take 
you up to the same point as you were 
at the end of part two of this series. So 
until then, have fun adventuring... 
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ADVENTURE WRITING 

Creating your own Adventures becomes more and more feasible as this series continues. 



Tilt ;>.:■.* : <]. .11 t ii" :i.lrl- 


of this senes 


have loncentraleo more on theory 


dull IMI <K ,,Jllna 

liiati'ogrammingof 


n ddwnlun- 


You w.il have haa : 








Uke and w.l m-ei 




and tnoose what aspms you would 


like to include. Now (he 


ugh we shiill 


actually gel In ihe main 


PPP5 or Pre- 


Programming Preparatio 


ns. "What?? 1 


thought you said 




programming this mo 


th!", 1 hear 


you shout. Well we wil 


- but only a 



very small amount. The PPPs must 
he done so that we can structure the 
adventure which. In this case, will be 
programmed mainly in BASIC with a 
touch of machine code to spice 
things up a bit. Remember that text 
compression program that I supplied 
with the first article? Well the 
machine code version of the 
decompression routine is on the disk 
this month as well as a further two 
pictures, again created by Doug 
Sneddon. 

These files are "AW-DECOM.MC", 
"PO" and "PIC3" respectively. The 
rihwmbly language source tile is also 
here for machine code programmers 
10 have a look at, filed as "AW- 
DECOM.5RC". There are plenty of 
extra comments to tell you exactly 
what each step is doing and it is 
compatible with the 65)0+ 
assembler, published by CDU a little 
while back. To load ihe actual code 
you use the standard ,8,1 suffix and 
execute the code with SYS4940B. 
Before doing this you must enter 
POKE2,L where 'L' represents the 
length in bytes of the compressed 
data. With this routine you can only 
have compressed data up to 254 
characters in length but an 
experienced machine language 
programmer should be able to alter 
the code to allow more. If you only 
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program in BASIC, nevermind. 

To see it in action in my AW- 
COMPRESS program, published with 
the first article, you should load and 
run that program as it stands and 
then press RUN/5TOP when it has set 
itself up with the main screen. Then 
delete lines 540 to 675 inclusive and 
replace them with: 540 POKE 2,CL: 
SYS 4940B. Of course, you must 
have first loaded the code, so delete 
the command CLR at the very start 
and replace it with: 5 A=A+I ; IF A=l 
THEN LOAD"AW-DECOM.MC".B,l. 

and RUN the program. The code will 
load and everything will be the 



same, other than the speed at which 
the decompressed text is printed! 

Right then, a minor change of 
subject! The very first thing to do 

come up with an idea for what your 
adventure will be about. Will it be 
fantasy or modelled on reality? What 

fictional world, a house or a futuristic 
setting are all possible ideas. This is 
the creative stage. Draw yourself a 

adventure landscape. My adventure 
will be set in a fantasy world and 
Figure One shows my idea. 

This will be a very small 
adventure but you can see the main 
components. Once you have got a 
basic idea of what will happen in 
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your adventure you should create a 
"square map". This should be much 
mote diagramatic with squares 



representing individu 


1 locations 


with lines linking them 




multitude of different 


methods of 


iti.ip rluwing that you c 


luld use but 


lor simplicity and what 1 


call "ease of 




res method 


lo Ix'vjin with. It is a lot 


asier to add 


lot alions than with othe 


methods. 


If you want to make 


n ad vendue 


more difficult then m 




Tinkini; paths" one-way. By this 1 




th to one 


I'" , i rlii.-s'niii m-ii' 


sarily mean 


lhat hy then going south again you 




place. By 


int orporaling features 


ke this you 


can very easily design 





obstacle". This is something like a 
maze and in that case you can make 
all directions possible "exits" but 
only have one thai moves you to a 
new lo< .it ion. The others return you 

others could keep you in the same 
location. By ensuring that the 
descriptions of these locations are 
the same, the player can become lost 
relatively easily. The example 
adventure, Uemad. incorporates a 

which is represented by locations 
nine to eleven in Figure Two, the 
square map. 

A number of terms were used in 
the lasl paragraph that I shall now 
clarify. They are all quite simple but I 
shall evplain them to ensure that you 
fully understand. Don't forget that 
this PPP stage Is very important. 
During your programming you must 
have something to refer to. But first 
Ihose terms - and a iew others. 

"Linking paths" are merely the 
lines that are shown on your square 
map so that you tan easily see which 




"Location obstacles" are features 
of your adventure that hinder the 
progress of the player. They are 



related to the actual location and in 
which directions the player can leave 
that location. This could be a maze 
as mentioned earlier or could be a 
light/dark situation. This could take 
the form of a dark tunnel where the 
player's movement is restricted until 
a lamp, for example, is lit, whereby 
new directions are made available. 
"Exits" is the term lhat describes 
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which directions a player can move. 
If on a mountain path that runs north 
to south, the possible exits are north 
and south. New exits can be made 
available under different 
circumstances. Fot example, wearing 
a magic ring could "open up" an exit 
to the east that may lead into a cave 
in the mountain. 

"Actual obstacles" are things 
found in the locations, or rooms as I 
shall now call them. For example if a 
large boulder prevented you moving 
west and it was possible to somehow 
shift it to "open up" the new exit, 
then this boulder is termed an actual 
obstacle. 

"Objects" are exactly what they 
say. They are found in the rooms and 
are the things than can be picked up, 
dropped, opened, closed and so on. 
In the previous example the boulder 
whould also be defined as an object. 
Some food, a key, a cupboard and a 
bag of coins are all examples of 

Once you have drawn your 
"square map" and have decided on 



the general descriptions of the 
rooms, you should mark on the 
positions of the actual obstacles. You 
shoultl have a ratio of about per five 
to seven rooms. This will require 
some thought. Next you must decide 
on how they will be overcome - (or 
example the boulder could be 
pivotted out of the way using a 
strong piece of wood. Don't make 
the solutions loo obvious bul then 
again don't make ihem so 
outrageously stupid thai no-one 
would be able lo solve them. If the 
latter is the case then the player is 
likely lo quil and put your adventure 
away to gather dust I 

The objects that solve puzzles 
can be termed "solution objects" 
and all others "collection objects". 
The latter could be something like a 
gold coin that is needed to complete 
the game. Obviously, the solution 
objects and the aclual and location 
obstacles should be placed with care 
as thought must be involved to 
ensure that the solution objects are 
available before the obstacles are 
encountered. It would be no good 
placing the piece of wood to shift the 

boulder. There is quite a bit more lo 
say about solulion and collection 
objects which I shall cover at the 
start of the next article. For now, 
though, it's your turn to do a bit of 
programming! 

What we need to design for next 
month is an input routine. This is 
very important because it is how the 
player conveys his commands to the 
computer and adventure program. 
You could use a standard INPUT 
command but a much better one 
would be specialised to accept only 
certain characters and length of 
input. Have a go at that yourself - I 
shall provide my version next month 
together with routines to get and 
display text and graphics and 
describe the present location. These 
can be adapted for your own use but 
will eventually be found in my 
adventure,- Demad. Splitting up the 
input and analysing it comes later 
on. Until next month, when we shall 
have a true programming session, get 
pi, i nning vour own adventure! 
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Problem solver JASON FINCH helps a few more readers out. 



Deal CDU. 

I -in. >-i whilst .it In keyboard a 
II... has .esulted In ml keyboard 
accumulating ash and going 
haywire Aitei dismantling Ihe 
<ompuler and blowing out the 
keyboard wilh a footpump Hie 
problem «4« temporarily rectified. 
However it in < urred again aftei 
ahoul a week and required the same 
treatment. There will come a time 
when the problem won't be solved 



< ommodoie HUSO dual llnpps disl 



! tins 



them for the 
though, be able 
by finding 
64 that 



'ill hay 



t one cheaper 
■ho ha* an old 
possibly a number of 
been damaged in 



faulty chips i 
some other way and i 
could then use the keyboard from 
that computet or alternatively some 
computer stores will have ones left 
from computers that they have been 
asked to repair but then it has been 
found (hat it would be 
uneconomical. I was able to get hold 
of one for only five pounds! The best 
bet though would be to contact HRS. 



i f.4 Please i mild vou help me. 

Matthew Langner, Hatfield. 



ing the Commodore 
ie tx f»tm\ m < .n: it De# Matthew, 
atlaih an. IKI ditk Wiidt you mil 



supplier thai sluiks these hei 
Holland. Maybe you can help n 



■ is alter the 
'itch on yo U r 
! BASIC line 
,"#":CLOSE4 



red if 



rob leti 



iund : 



you knew of some supplier who c; 
supply me wilh a replacement 
keyboard. 

Derrik Nash, The British Forces. 

Dear Derrik, 

There is fl company in Birmingham 
that will supply replacement 
keyboards. They are HRS E I ec Ironies 
Pk and their address is Garretts 
Green Lane. Birmingham, B33 OUE. 
The telephone number is 02I-7B9- 
7575 and the keyboards are about 
forty pounds (including VATI for a 
C64 keyboard and around twenty- 
four pounds for C64C keyboards. 



>uld displayed Then keeping this switch 
information set like that, which I think is the one 
in help me to dealing wilh international fonts, load 
Jual drive. up GEOS and type your letter. 

Hans Sjoerds, Holland. Whenever you want a pound sign to 
be displayed use the hash mark (#). 
Then when you output in NLQ 
mode, the printer should display a 
pound sign instead of the hash mark, 
that you Thanks go from me lo FSSL for 
They are Meedmore providing that bit of information, 
based at 28 Farriers 



n pleased to be able to tell you 



that ther 

I n;;l;n'n'i that stock the 
Limited and 

Way, Nelherton, Merseysidi 



. The 



L39 



Com 



64 IEEE 



just short of eighty pounds. This 
includes VAT and postage in the UK. 
although I a 



ind il costs solve a little problen 



program on the CDU disk Volume 3 
Number B. The file is the POPP 
program for the CI 28 computer. 



costs are incurred by sending i 
other countries, I hope I have been 
able to set you on your way. 



Dear CDU. 
I own GEOS 
brilliant pa. 
which i piou 



ind what problem is that when I load it ii 



sign II . 
letter In 



memory I get an Illegal Quantity 
error in line number ten. 1 hope you 
can solve this for me. 

A.G. Jones, Hull. 



DOU C00UD4I 

ble cause- tot u 

me is tnat you are attempting 



- |.m W ,- 



i in the 



lard 



found out thai this »ign appei 
■>■; ii you prim il oul using th 
mode df Draft mode. Only o 



Mi; 
High 



ii monv I his means mat 
he value lor the horizontal widtb ot 
he winnow is reditu to a 
naxiii, u .n of 1<9. But the command 

pet it e> a width ot 7'i and Mwrafow 

nude, an 'tttflll Quantity emu will 
t ^emuled 



31 



Dear CDU, 

I wonder if you would be good 
enough Id answer Ihe following 
couple of questions. I have recently 
acquired a second CBM1541 drive 
and after a slight repair the machine 
is as good as new. Is it an advantage 
and to what uses can I put it* 

R.I.Pike, Lichfield. 



Having a second drive is certainly 
acltanr.jget.ius even though it may not 
seem so at the stan. This will make 
itself increasingly apparent as you buy 
new software or your needs are 
increased and you will find more and 
more uses for the new drive. Copying 
of disks (your own - not piracy, 

because it eliminates the new) to keep 
swapping the source and destination 
disks. Also, you have effectively got 
twice as much space ro access at the 
same time. If using a word -processor 
or spreadsheet you could have thy 
main system disk in one drive and 
your work disk in the other. Then if 
the program needed to keep 
ace essing the main disk you wouldn't 
need to keep swapping them around. 
Also there are many uses for a second 
drive when programming and I am 
e of them will make 



ther 



Dear CDU, 

There appears to be some faults on 
the CDU disk that I received recently 
(|une issue). None of Ihe 128 
programs are found by the drive for a 
start. Also when trying (he Sprite. Bas 
demo it instructs one to load the 
Sprite Basic program but pressing the 
space bar results in the screen going 
dead, no cursor, no activity. Other 
programs at fault are Ihe Aleatory 
Music which, after loading, produces 
a syntax error in 17190. The copier 
program is also faulty. After pressing 
either F5 or F7 there is no activity at 
all. With regard to the new menu - I 
do not like it. When using the cursor 
to select a program it is only possihle 
to go down the program list, using 
SHIFT does nol enable on to go hack 



up the selections again, and I found it 
only too easy to overshoot the 
selected program. I have sent the disk 
back to Select Subscriptions but hope 
you can shed some extra light on the 

£ . C . Am es bu ry, West on-5u per-Mare. 

Di-.ir iMr.Amesbury, 
It certainly sounds as though the disk 
was corrupt and I hope that the 
replacement copy will work when 
you receive it. However, there may be 

programs not working. The 1 20 ones 
for example. These do mil load using 
some 1571 drives because they are 
protected. This protection must be 
removed using a disk editor or a 
directory editor before the programs 
will load. Alternately put the drive 
in 1541 mode. The reason lor the 
Sprite. Bas program not working could 
be the fault of a (astload cartridge of 
some description that you have fitted. 
List line 30 - ihe last statement should 
be SYS64718. If it is this then the 
computer should reset itself. You will 

before Ihe |x>we(-up message appears. 
Alealory Music can also produce 
errors if a cartridge is active because 
of the way it is "decompressed" out to 
its slandard length. If it still produces 
an error when you get it back, try it 
without anything else other lhan the 
drive and monitor attached. I cannot 
see what the problem wilh the menu 
is. It is programmed to respond to the 
SHIFT and cursor down key so that 
upward movement is possible. These 
are all only possible causes for the 
separate errors, of course it may be 
thai parts of the disk have been 



Dear CDU, 

The main reason for writinu i- In find 
out how to get multicolour sprites. 
The user manual does not help much 
(not at all really). I would also like to 
know how to get the computer to 
automatically enter data created 
from a sprite editor program I have 
written. I need to enter about ten 
lines. I hope you can help. 

David Mayes, Kent. 

Dear David, 



of a 



spritt 



controlled by register number 28 in 
the VIC-II chip, location number 
53276. To switch on multicolour 
mode by entering POKE 53276, 
PEEKI53276) OR 2*N where *N' is 
the number of the sprite from zi 



To < 



Off 



multicolour mode use POKE 53276, 
PEEKI53276) AND 255-(2"NI. If you 
understand binary then the eij>ht 
sprites are represented by the eight 
bils of location 51276, sprite zero 
being the far right bit zero, and sprite 



n bein 



s far 



you wanted sprites [1,1,4 and 
6 to be multicoloured the value to 
enter would be the decimal 
equivalent of 01010011 which is B3. 
Thus you would type POKE 
53276,83. As for entering the dala, 
there are a number of ways. By far 
the simplest is to gel the computer to 
print out a line a.^ ii uou had typed 'I 
then to print a statement such as 
COTO 500 beneath that and then to 
exit the program. Before doing this 
the keyboard buffer is loaded wilh 
two carriage returns. Then when the 
program exits, the line will be 
entered and the GOTO 500 
statement executed which returns to 
the program. However there is one 
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huge problem with this. Whenever a 
line is entered into the computer's 
memory, all variables are cleared. If 





technique is line. The other 


melhofl 


s too complicated to explain 


here bu 


h ~*= «*»«r playing 






pointers 


If you want to store a few 


variable 


then POKE them to some 




(679-767 are handy) before 


exiting 


md then retrieve them by 


PEEKin 




"'I'li'iin 


. 1 hope that the technique 



is suitable because on the disk you 
will find a program filed as 
"TECHNO INFO" thai will ask you to 
enter a value between I and 100. 
That many random numbers are then 
generated and stored in blocks of 
eight as DATA statements. I have 
fully REMmed the program so thai 
you can see what is happening. I 
hope I have been of some assistance. 



Dear CDU, 

I would like to read to (wo letters I 
read in your May 1990 issue. Maybe 
I can be of some help to the writers. 
My firs! remark is for Mr. Booth from 
Bristol. He experienced trouble with 
the Power Carlridge. Purely by 
coincidence I mel another C64 user 
the very day I received CDU who 
had suffered from similar effects. 
Here is the story: His C64 (old 
model) broke down - one of the 
CIAs blew up, making some 
operations very hard. So he bought a 
new one. It worked perfectly until 
he installed the Power Carlridge. 
Withnul it there was no problem. So 
he switched computers ■ hark lu Ihc 
old one Result trouble. He 
borrowed another 64 Irom a friend 
and connected it Result • system 
going haywire. In a last attempt he 
replaced the power supply block of 
his new 64 with the one ui h.s old 
64. Revolt all computer, worked 
perfectly (apart Irom Ihe one with 
Ihe broken CIA of (nurse). 
( unilusion • the fault might be in 
the power supply. To control this he 
fetched his multimeter and checked 
out the voltages. And here comes 
some confusion I don't understand - 



on Ihe 5 volt supply pin of his oldesl 
power supply (which worked) he 
found a voltage of 4.65V and on Ihe 
new supply (the one with the 
problem) he measured 5.05V. 
Anyway my conclusion still is that it 
might be helpful to have your power 
supply checked out, for this may be 
the cause of your trouble. My 
second remark is for Adam Trickett 
of Leeds. He asked if there is a 
GEOS printer driver for the Citizen 
120D. Well, here is some good news 
for him: there is such a specific 
driver, however not in England. I 
would like to send it to you, bul I 
think that could mean problems 
with respect to copyrights, for it was 
published in a German magazine, 
64er Sonderheft Nr.28 some time 
ago. But don't panic: if you write a 
letter to their publisher, I am sure 
they would be willing to help you. 
Their address is: Markt & Technik 
Verlag AG, Hans Pinselstrasse 2, 
B013 Haar bei Munchen, West 
Germany. Now don't think I am 
advertising for your "rivals", for 
64er publishes lots of good articles 
and programs and I often buy their 
magazine at my local newspaper 
shop, but my postman brings me 
CDU every month at home, for 
CDU has the programs on a disk, 
whereas 64er gives me blue fingers! 
Keep up the good work! 

|an Kerkhof, Belgium. 

Dear Ian . 

I cannot thank you enough for all ihis 
information and I hope that 
everything will be sorted out for the 
people that have experienced 
problems with BDL's excellent Power 
Cartridge. I hope Adam can write 
German! That's a joke of course, I 
would otpeci that there is someone 
there that ran read English. Thanks 
once again for the info. 



Dear CDU, 

With reference lo Simon Searle's 
letter requesting a copy of Laser 
BASIC. I have a tape version of White 
lightning which contains BASIC 
LIGHTNING which is almost the 
same as Laser BASIC which Ocean 



version of forth designed for writing 

condition and I would like" ten 

Raymond lloben. Dumbarton, 
Scot laud. 

Dear Raymond, 

Thanks for vour letter If, Simon, you 
would like to buy this piece of 
software from Raymond at a cost of 
ten pounds ihen I would like you lo 
get in touch with me again to confirm 
everything, I will then pass your 
address on to Raymond and you two 
ran take things from there. 



Dear CDU, 

Can you please help me. What I 
would like is for you to ask whether 
any of your readers has a copy of the 
Laser BASIC Compiler for the 64. I 
am willing to pay for it. 

D.Beeley, Manchester. 



Dear CDU, 

With reference to Ihe letter in 
Techno Info from Adam Trickett in 
the May 1990 issue, 1 think Ihe 
problem may be that the compiler is 
supposed to compile Laser BASIC and 
not standard BASIC programs, 
although I am not sure. I have Laser 
BASIC and 1 have been trying to gel 
hold of the compiler for a while so if 
it is no good to Adam I would like lo 
ask if he will set if to me (original 
with instructions please). So if you 
could please print this letter I would 
be extremely grateful. 

M.Le-Vallois, Paisley, Scotland. 



Dear Mr.Beeley/Le-Vallois, 



We seem tc 


have a little conflict here. 


Obvious k 


ow, Mr.Beeley, you know 


of someon 


with the Laser Compiler 


who, for o 


e reason or another, was 




npressed with it. Mr.Le- 


possible l:a 


u have picked up on a 
use but of course we do 




whether Adam Trickett 


r^war 


ts to sell this piece of 




not. 11 both Mr.Heek-", aixl 


Mr.Le-Valk 


s would please write to 




ne of the maximum that 
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they would pay or an amount that software, and if so how much you 
they would want lo pay I would be would want lor it. In the meantime, 
grateful. Also Adam, could you please anyone else who has a copy of it that 
they would sell, plea 



isk for it. I am sure that somehow all 
his will work itself out and we may 
j ven be able lo salisl\ bolh Mr.Hivlrv 
look forward to 



e prepared to sell the with details nl how much you would your further corresponded 



TIP OF THE MONTH 

Well all my pleas seem to have paid off but «. 
only had the following two tips sent to us 
readers. If anyone else has any piec 
ihey ihink may lie useful Ihen please send it in lo us. The 
first one is a little batch of POKEs and comes lo you 
cuurtesy of Mr D.Beeley in Manchester: 

POKE775,200 will disable the LIST command, and 
POKE775,167 will return to normal 

POKE774,226:POKE775,252 will result in Ihe computer 
resetting itself if the LIST command is entered. 
POKEb49,0 will disable the keyboard, and POKE649,10 
will return to normal. This should be used from within a 
program because otherwise you can't type the second 
POKE to return to normal! 

POKE8U8,254 will prevent the use of RUN/STOP, and 
POKE80B,237 will return il to normal. 



directory editor then you have no excuse now, hat 

Thanks musl go to both Mr.Beeley and Mr.Williams fi 
those tips. Hopefully some more of you will come u 
with some others now ihat you see it really is possible I 

y<mr lips publ'shed! Please everyone remember Ihe 
NEW ADDRESS it you have any programming prohlen 
or general queries, or if you want lo have something 
published in the Tip of the Monlh section (please mark 
your envelope with the word TIP), The new address, z 
published last month, is: CDU Techno Info, II Cook 
Close, Brownsover, Rugby, Warwickshire, CV21 1 NG. 
Please note that ihis is only the address for Techno I 
All other correspondence and contributions should be 
sent lo the main address lo be found elsewhere in 
1 in I ill. at urn. >(■(■ vim .ili jjj.iin next month! 



Nip -econrl tip is slightly longer arid more complex and 
was sent in by Steve Williams, mini ulerillv also from 
Manchester. It concerns the use of CDU MENU KIT 
written by Neil Higgins (Volume 3, Number 2); 

I have found a way to get Ihe menu as the first file on 
your disk without the use of a disk editor. Firstly, take a 
formatted disk and put il in your drive! Then type 10 
REM and press RETURN, then type SAVE "NAME",8 
where NAME represents the name of the program to go 
in the menu. Repeat the save instruction as many times 
as vou need, saving each time with a different title for 
each piogram. tnsurr that the title von give matches Ihe 
title from ihf first pari of eai h program ■ especially it it is 
in multiple parrsi Swilih off and Ihen on again before 
the not bit! load the CDU MENU KIT and replace Ihe 
disk with all vOur titles on. When the program asks if 
you wanl lo include something you should say ves and 
include Ihem all. Now sort out your colours and when 
you have done thai save the finished menu to a different 
iiewlv lormatled disk. Ml vnu have In do now is save 
each separate program complete with anv extra parts 
with Ihe iile copier from ( l)l. if vou feel thai w.n 
inclined. Ihen switch off and nn again and type 
LOAL)™"",B.I. Your personalised menu i> alreadv al the 
start ol your disk-full oi goodies. All without Ihe need 
for a directory editor 11 may look a little long winded 
when you first look at this but il's not when you get 
stuck in. If you haven't been able to put your menus at 
the start of your disks before because you didn't have a 




IF AN 
'ADVERT IS W 
PRINT, IS IT PROPER? 
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EXPLORING THE 1541 

Learn more about the inner workings of your 1541 disk drive 



isk drive. what can you 
fell the simple answer is, 
il you understand how 
orb. By the end of this 
should have grasped 

this 'Rectangular Box'. 



S WICKHAM 



n what you a 



the drrv 



(See 1 541 layout]. Of these 35 tracks, 
there's one very important one, this is 
track 18. Track IB is known as the 
BAMIBIock allocation map) and and 
the DIRECTORY irack. The BAM 
what tracks and sectors 



SEQUENTIAL FILE 
FORMAT 

BYTE DEFINITION 

BUT FINAL SECTOR 

Track and sector of nexl 
sequential data block 
254 bytes of data 



ri the Dirs 



(rid win. 



ory tr 



1541 will prr.hablyoi 
for storing program 



sxpefienced u 



ying tr 



e go 



aboul each file that is stored 
disk. (See 1541 layout). Before we go 
into more detail, opposite is the layout 
of the tracks, and the sectors of the 
1541, together with the sort of 
liormation that they contain. 



again, heard it all before'. Before you 

Coffee though, read on. ...Its never Loo 
late to learn new things. 

This article is MAINLY for the 
1541/1570 users, although much of 
the info is also pertinent to the 1571. 
Where possible. I will give examples 
for both units. [For example, 



e with the 1541 you use 
BA5IC 2,0 commands, but for the 
1571 you can also use BASIC 7.0 
commands.) How do you go about 
learning about something like the 0,1 
1541 , the first thing you should know 
is how the information is stored on 2-255 
the diskettes that you spend your well info stored a' 

earned money on. To be able to 
understand that, you need to know 
how a diskette is marie up. 



ir of next 
block in program file 1 
2.3 Load address of program 

4-255 Next 252 bytes of prg 
info stored as in comp 
mem .(keywords 
tokeniied] 

REMAINING FULL SECTORS 

0,1 Track and sector of next 

block in program filel 
Ne.it 254 bytes of prg 



Inlormation is stored on the diskette 
on TRACKS. On a standard 1541 disk 
there are 35 of these tracks. Each 

SECTORS. The sectors are the areas 
thai contain the bytes of data. Each 
sector holds 25b bytes. The tracks are 



FINAl SECTOR 

0,1 Null (S0O), followed by 

number of valid data 

bytes in sector 
2-!(( Last bytes of prg info 

stored as in comp 

mem. (keywords 

token i zed I. 
The end of a BASIC file is marked by 

remaining bytes in the sector are 
garbage and may be ignored, 



-255 



FINAL SECTOR 

0,1 Null ($00), followed by 

number of valid data 

2-??? Last bytes of data. Any 

remaining bytes are 
garbage & can be 
ignored 



data block 

254 bytes of data. Empty 
records contain SFF (all 
binary ones) in the first 
byte followed by $00 (all 
binary zeroes) to the end 
of the record. Partially 
filled records are padded 
with nulls ($001 



SIDE SECTOR BLOCK 




0-1 Track and 


ector of next 




block 


2 Sidesecto 


number (0-5) 


3 Record le 


gth 


4-5 Track and 


■ector of first 


sidesecto 


(number (1) 


6-7 Track and 


■ectorof 


second side sector 


[number 1 




8-9 Track and 


ector of third 


side sector 


(number 2) 


10-11 - Trackand 


ector of fourth 


side sector 


(number.!) 


12-13 Tr.ii k ,ind 


ector of fifth 




(number 41 


14-1 5 Track and 


ectorof sixth 



35 



FEATURE 



side sector (number 5) 
1 6-255 Track and sector pointers 

to 1 20 data blocks 

DIR FILE FORMAT, TRACK 
1B SECTORS 1-19 

BYTE DEFINITION 



DISKETTE FORMATS 8 LAYOUTS 



0,1 


Track and sector of next 




directory block 


2-31 




34-63 




66-95 




98-127 




130-159 




162-191 


File entry 6 


194-223 




226-255 




STRUCTURE OF EACH 


INDIVIDUAL DIRECTORY 


ENTRY 




BYTE CONTENTS DEFINITION 




+type File type OR'ed 




with J80 to 




indicate pmperlv 








(if OR'ed with 




JC0 instead, file 




is locked! 




TYPES: 




0 = DELeted 




1 = Sequential 




2 = PROGram 




3 = USER 




4 = RELative 


1-2 


Track and sec lor 




of first data bku k 


3-18 


File name [.viildC' 1 




with shilitii ^p.ii I-. 


19-20 


Rel file only. Track 




and sector ( jf lirsl 




side sector 


21 


Rel file only. 




Record length 


22-25 


UNUSED 


26-27 


Track and sector 




of replacement file 




during an 




@SAVEor@OPEN 


28-29 


Number or blocks 




in file, stored as a 




two-byte integer 




in normal lo-byte 




hi-byte format 



1 he above inkirmal un ;i 



Block distribution by Track 




Track Numbers 


Range of Sectors 


Total Sec S-Sided D.Sided 


HEX DEC 


HEX DEC 


HEX DEC 


$01-$11 01-17 


S00-S14 00-20 


$15 21 YES YES 


S12-S18 18-24 


$00-$12 00-18 


$13 19 YES YES 


$19-$1E 25-30 


SO0-S11 00-17 


$12 18 YES YES 


$IF-$23 31-35 


S00-S10 00-16 


111 17 YES YES 


S24-S34 36-52 


$00-$14 00-20 


$15 21 NO YES 


$35-$3B 53-59 


00-S12 00-18 


$13 19 NO YES 


S3C-S41 60-65 


SO0-S11 00-17 


$12 18 NO YES 


S42-S46 66-70 


S00-$10 00-16 


511 17 NO YES 


BAM FORMAT 1541 - TRACK 18 SECTOR 0 


BYTE NUMBER 


CONTENTS 


DEFINITION 






Track of new directory block. Always 1 8 






Sector of nest directory block. Always 1 




65 


ASCII chararac ter A indicating 






1541/51/71/4040 format 






Double sided flag. Ignored on 1541 






Number of sector available on track 1 


5 




Track 1 , sector 0-7 availability map 


6 




Track 1 , sector 8-16 availability map 


7 




Track 1. sector 17-23 availability map 






Number of sector available on track 2 


9 




Track 2, sector 0-7 availability map 






Track 2, sector 8-16 availability map 






Track 2, sector 1 7-,'S availability map 




....ETC DOWN TO... 


140 




Number of sector available on track 35 






Track 35, sector 0-7 availability map 






Track 35, sector 8-16 availability map 






Track 35, sector 1 7-2.5 availability map 


144-1 59 




Disk name padded with shifted spaces 




ICHRSI1601I 


160-161 


160 


Shifted space |CHR$(160)| 


162-163 




Disk ID 


164 


160 


Shifted space (CHR$(1 60)| 


165-166 




ASCII representation of 2A which are 






respectively the DOS version (21 format 






type 1540/41/51/71/4040/2030 


1 67-1 70 




Shifted spaces 1CHR$(160}| 


171-255 




Nulls |CHR$(0l|. not used 


1 571 DRIVE AS ABOVE EXCEPT 








Double sided fiag:$B0=Double Sided, 






S0O=Single Sided 


171-220 




Nulls (CHRK0II, not used 


221-237 




Number of sector available track 36-52 






(each sector by each byte) 


238 


0 


Number of sector available track 53 






(always 0, all seciors allocated 


239-244 




Number sector available !k 54-59(each 






tk by each byle) 


245-250 




Number sector 'available tk 60-65(each 






tk by each byte) 


251-255 




Number sector available tk 66-70(each tk 






by each byte) 



FEATURE 



each (rack and sector is made up. and 
'a Ii,ii imorin.it inn i ■. j 1 1 ■ _ h i ■ n i I lli>< v -. 
Later in the article, I will explain just 
HOW the information is written to the 
disk. Before we get loo technical 
though, I want In show you some of 
the commands available to you and 
how we use them. The table below 
shows you the various commands 
available, (Using BASIC), both for the 
1541/1570 and for the later version 
1571, After the table I will 
demonstrate exactly how to use each 
sing BASIC 2.0 the 



INPUTS INPUTfn,variable li 
BASIC 7.0 

BtOAD BLOAD "filename" 
Bankff.Starl arklriM 
BSAVE BSAVE"filename" 
Bank#. Start add res 
end address 
BOOT BOOT "file name" 
OPEN DOPEN#fn, 

"filename"] record 
length], 1WI 
CLOSE DCLOSE#fn 
RECORD RECORD#fn.recor 



general format i 


:- OPEN15,8,15: 




number!, offset 1 


PRINT#15."comn 


and":CL05E15 or 


PRINTff 


PRINT#fn,data list 


OPE N 1 5,8, ) 




GET# 


GET#fn,variable list 


tetterOiinforma 


ion":CLOSE1 5. 


INPUT* 


INPUT#fn,vanable list 


(NOTE:- The 


irst 15 in the 






OPEN/CLOSE c 


ommand is not 






mandatory. This is 


ust the file number 










DIRECT ACCESS 


(Normally though 




COMMANDS 


used). 




BLOCK-ALLOCATE "B-A";0,lrack; 



reserved as the COMMAND channel. 
Data transfer over this channel is as 
follows:- Opening the channel 
(OPEN) 

Data transfer (PRINT) 
Close the channel (CLOSE) 

When you initially open the channel, 
you specify a logical file number, this 
number musl be in the range of 1 to 
127, the device number of the drive, 
(this is normally 8 for single units), 
and a secondary address. (15 for the 

number is used in any subsequent 
commands, any number of 
commands can be sent until the 
channel is closed. These commands 
must be referenced by (he logical file 
number first used in the OPEN 



HOUSEKEEPING 
COMMANDS 

BASIC 2.0 

NEW "N0:disk name.disk id" 

COPY "C0:new file=old file" 

RENAME "R0:new nam=old name" 

SCRATCH "Sffiftle name" 

VALIDATE "V0~ 

INITIALIZE "10" 

BASIC 7.0 

NEW HEADER"diskname",id,dv 
COPY COPY"old file"TO"new 
file" 

RENAME RENAME"old name'TO" 

SCRATCH 5CRATCH"file name" 
VALIDATE COLLECT 
INITIALIZE "10" 

FILE COMMANDS 

BASIC 2.0 

LOAD LOAD"filename",8 or 
LOAD"filename",8,l 
SAVE SAVE"filename",8 
VERIFY VERIFY"filename",8 
OPEN OPENfn,H,channel," 
0:filename,file type, 
direction" 
CLOSE CLOSEfn 
PRINT# PRINT#fn,data list 
CET# GETOl'n.variable list 



BLOCK-EXECUTE "B-E";channel, 
0;track,'sector 
BLOCK-FREE "B-F";0;track; 

BUFFER-POINTER "B-P";channel; 

byte 

BLOCK-READ "U1 ";channelfl; 

trackjsector 
BLOCK-WRITE "U2";channel;0; 

track;sector 

MEMORY-EXECUTE "M-E"CHRS 

(<address>CHR$ 
(>address) 

MEMORY-READ "M-R"CHRS 

(<address)CHR$ 
(>address)CHRS 
(number of bytes) 

MEMORY-WRITE "M-W'CHRS 

teaddress)CHR$ 
(>address)CHR$ 
(number of bytes) 
CHRSIdata byte) 
CHRSIdata byte) 

USER "Uchar" 
UTILITY LOADER "&0:file name" 
BURST H571only)"U 

chaT+charadeiH 
Commands intended for the drive are 

Communication with the disk drive 
can be achieved over any 1 of 15 
channels. Channel 15 however is 



NEW - Formatting a diskette 

The command NEW formats a 
diskette, thai is to say, it prepares a 
new diskette for receiving data. As in 
all commands, the command word 
NEW can be reduced to a single letter, 
EG N=NEW. R=RENAME. For clarity, 
I will show all commands in their 
condensed format. That is to say that 
instead of OPEN 1 5,8, 1 5:PRINT 
#15,"NEW:name,id". I will use the 
much shorter method of 
OPEN1 5,8, ) 5/'n:name,id". Therefore 
to Format a new diskette we use the 
c ommand :- 

OPEN15,8,15,"N:name,id" 

COPY - Copying files 

This command allows the user to 
copy a file already present on the 
diskette The command is however 
seldom used, its only real benefit is in 
the ability to combine several 
SEQUENTIAL files logether to make 
one larger file. This method cannot be 
employed on PROGRAM liles though. 



RENAME -.Renames a file with a 

This command allows the usi 
change ihe name of a file on di 
works on all file types. 
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OPEN1 5,8,1 5,"R.new 
name-old name' 

SCRATCH - Scratch a file 

This command allows you 
of any redundant files. Il 
added advantage lhal ) 
scratch more than one He at 



OPEN15,8.15,"S:prOB 
■ this would get rid of prugl only 
OPEN) 5,8,1S,"S:proRl, prog 



(Later on you will learn how you can 
RECOVER flies that have been 
scratched by mi stake I, 

VALIDATE - Validate diskette 

This command allows you to 'Clean 
up' or Validate your diskette. 
Whenever you Scratch a program, the 
program itself is still on the disk. All 
that happens is that the entry for that 

directory Validating your diskette 
makes the space of scratche'd files re- 



OPEN1 S.fi 



5,"V 



INITIALIZE - Initializing the diskette 

The DOS, or Disk operating system, 
requires a SAM, (Block allocation 
mapl, to be present on each disk. If 
you should change disks in the drive 
when using il, the D05 will not know 
that you have a different disk in the 
drive. Therefore it will be working on 
the old BAM. In combat this, you can 
s the 



e the 
DOS to read the ni 



I BAM. 



Now that we have dealt with the 
basic commands for talking to the 
drive, lets go on to the more exciting 
commands. These commands are 



i the 



I Acce 



commands. Once you understand the 
concept behind these commands, and 
what they are capable of, then 
programming the drive in BASIC is far 
more entertaining. However, before I 
go into more detail about these 
commands, I feel it is time we had a 
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1541 MEMORY MAP 






DRIVE ADDRESSES 






HEX 


DEC 


DESCRIPTION 




$0000 




Command code for buffer 0 




$0001 


1 


Command code for buffer 1 




$0002 


2 


Command code for buffer 2 




$0003 


3 


Command code lor buffer 3 




$0004 


4 


Command code for buffer 4 




V 1| )\ lr,-< H II ) 


6-7 


Track and sector for buffer 0 




$0008-0009 


8-9 


Track and sector for buffer 1 




Si )( H1-\-(H )i itf 


10-11 


Track and sector for buffer 2 




S0utl(".-()( Mil) 


12-13 


Track and sector for buffer 3 








Track and sector for buffer 4 








ID for drive 0 




S0014-OQ15 


20-21 


ID for drive 1 








ID 




$ni ho "fin' ^ 




Flan li" head transport 




SOtHO-Oi H 1 


48-49 


Butler pointer fur disk controller 




$0039 


57 


Constant B, mark for beginning 


f data block 












58 


Parity lor data buffer 








Drive number tor disk controlle 




$003F 


63 


Buffer number for disk controlle 




$0043 


67 


Number of sectors per track for 


irmatting 


$0047 


71 


Constant 7, mark for begining o 


data block 






header 




$0049 


73 


Stack painter 




StllMA 


74 


Step counter for head transport 




$0051 


81 


Actual track number for formatti 




$006!) 


105 


Step size for sector division (10) 




$006A 


106 


Number of read attempts (5) 








Pointer to address lor M and B c 


mmands 






Device number + $20 132 decl 1 


r Listen 


|™ 


120 


Device number + $40 (64 dec) 1 


rTalk 






Flag for listen (I/O) 




$007 A 


122 


Flag for talk (I/O) 




$007C 


124 


Flag for ATN from serial bus reef 


ving 


$007 D 


125 


Flag for EOI from serial bus 


$00 7F 


127 


Drive number 




$0080 


128 


Track number 




$0081 


129 


Sector number 








Channel number 




$0083 




Secondary address 




$0084 


132 


Secondary address 




$0085 


133 


Data byte 




$0OBB-OOBD 


139-141 


Work storage lor division 




SU094-0095 


148-149 


Ai tu.il bulter pointer 




S0099-009A 


153-154 


Address of buffer 0 $0300 




$OO9B-0O9C 


1 55-1 56 


Address of buffer 1 S0400 




$009D-004E 


1 57-1 58 


Address of huffer 2 S0500 




$O09F-00AO 


159-160 


Address of buffer 3 $0600 




S0OA1-O0A2 


161 -1 62 


Address of buffer 4 $0700 




$0OA3-O0A4 


1 63-1 64 


Pointer to input buffer SG2LK1 




$00A5-00A6 


1 65-1 66 


Pointer to buffer error message $02D5 


$00B5-Q0BA 




Record number LO, block number LO 



SOOBB-OOCO 


187-192 


Record number 1 II, block number 


S00C1-00C6 


193-198 


Write pointer for REL file 


SU0C7-00CC 


1 99-204 


Record length for REL file 


SOOD4 


212 


Pointer in record tor REL file 


SOOD5 


213 


Side sector number 


SOOD6 


214 


Pointer to data block in side sector 


JU0O7 


215 


Pointer to record in REL file 


SOOE7 


231 


File type 


$00F9 


249 


Buffer number 


SOItMJ-0145 


256-325 


Stack 


$0200-0220 


512-552 


Buffer for command siring 


$024A 


586 


File type 


$0258 


600 


Record length 


$0259 


601 


Track side-sector 


$025A 


602 


Sc( lor side-sector 


$0274 


628 


1 ength ni input line 


$0278 


632 


Number of tile names 


$0297 


663 


File control method 


$0280-0284 


640-644 


Track of a file 


$0285-0289 


645-649 


Sector of a file 


$02D5-02F9 


725-761 


Buffer for error messages 


$02FA-02FC 


762-764 


Number of free blocks 


$0300-03 FF 


766-1023 


Buffer 0 


$0400-04FF 


1024-1279 


Buffer 1 


S050O-O5FF 


1280-1535 


Buffer 2 


S0600-06FF 


1536-1791 


Buffer 3 


SO7OO-07FF 


1792-2047 


Buffer 4 



look at the 'Memory Map' of the 
1541 . To be able to program the drive 
erlii ienlly, you will need to know it's 
inner workings better. This is very 

experiment with M/C programs. 

Right now, let's go on to the 
'Direct Access Commands'. These 
commands will all be in BASIC, 
I Mdi lime (. oiler 's lie patient). 

Looking at the memory map, you 
can see that there are 5 buffers. 
However, only 4 are free for your use. 
(Buffer 4 is normally used for the 
BAM). Also please note that when 
using 5eq and Rel files at the same 
lime, buffer 3 is also not available 
because the Directory uses it. When 
you wish to use a buffer, you first 
have to OPEN a channel and specify 
which buffer you wish to use. For 
example OPEN 1 ,B,2,"#2" would 
open the channel to Buffer number 2. 
However it is good practice to not 
specify the actual buffer number but 
let the DOS select it for you. You 
achieve this by OPENing x,x,x,"#". If 
your selected buffer contains 
Alphanumeric Data, and is not over 



88 chars in length. You can use the 
INPUT* command. (Providing the 
d.itj is st'p.njtL'tl liv ,i cirri. ijje return). 
Otherwise you have to use the CETt 
command. Remember though, that 
when using GETS it does not allow for 
null values, therefore we have to 
check for it via 

IFAS='"'THENA$=CHr!$(0). 

Before we go any further there are 
4 things you must remember: - 

1 . The PRINT# statement sent to the 
command channel 1 5, sends a 
direct access command to the DOS 

2. A PRINT# statement to channels 
2 through to 1 4 sends data to a 
buffer. 

3. An INPUT# or GET# statement to 
channel 15 returns any error 
messages. 

4. An INPUTS or GETS statement to 
channels 2 through 14 reads data 
from a buffer. 

The Block-read command tells the 
1541 to read a sector from the disk 
into your openend buffer. (Strictly 
speaking this is known as a DIRECT 
ACCESS FILE). Because the first byte 
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ol the block does not get read with the 
Block-read command this command 
can I* shortened to U1 or B-R. The 

copy the buffer contents onto the 
desired sector on the disk. Block-read 

Therefore, the obvious aik-anu^c In 
this command is to READ data inlo a 
buffer, alter it, then re-write it back to 
the disk. The Block-Allocate, or B-A 
command allows the user to reserve 
blocks on a disk The main purpose of 
Ihis command is to prevent data from 
being overwritten. The Block-free or 
B-F command is the opposite to the K- 
A command. It tells the the BAM 
which blocks to make available. The 
Butler-pointer command, shortened to 
B-P is to tell the DOS just where you 
wish to start reading or writing data 
to/from. 

The Block-execute, shortened to 
B-E Is quite a powerful command. In 
essence, you read a sector from the 
disk into your previously opened 
buffer. The contents are then executed 
as a machine rode program from 
within the buffer, In practice when 
using this command, you specify the 
buffer number in Ihe OPEN command 

commands above, you have a few 
commands that allow you to access 
the DOS. (Disk Operating Systeml. 
These are: A.Memory-read 
B. Memory-write and Memory- 
execute, shortened to M-R.M-W and 
M-E respectively. 

I will now give a few examples of 

Operation. Feel free to experiment, but 
always make sure that you work on 
disk with no important data on it. 
(Mistakes DO happen). 

NOTE:- When using the D/A 
commands, there are two methods 
available. Either may be used 
depending upon your own 
p reference :- 

Method A is PRINT#1 5, 
"U1 :"channel number;drive 

Method B is PRINT#15,"UT 
channel number drive" 

If using method B remember to 
leave a space between each item 
inside the quotation marks. 
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BLOCK READ 

Suppose you wished to follow a 
|»SMm through on (he disk b) track 
and sector without actually reading 
Ihe data. To do this you need to 
follow the path of the Link' bytes. 
That is the 2 bytes at the start of each 
block that tells you the track and 
set.ttir of the next block. See Fig. 1. 



BUFFER POINTER 

Suppose you wish to read the diskette 
name from within i program. As you 
know the name starts at position 144 
of track 16, sector 0. Normally you 
woulrl have to read the first 143 bytes 
and ignore them. However the .DOS 
has an easier way. You can point to 
any position within the buffer by the 



B-P command The bytes are 
numbered 0-255 in the buffer, the 
buffer pointer can be set to zero 
automatically by the use of the Ul 
command though. See Fig. 2. 



BLOCK- WRITE 

Block-writ!;, is used in conjunction 
with the block-read command. It 
allows ant to write Ihe contents of a 
buffer onto the disk at any desired 
position. The command does NOT 
aller ihe contend of Ihe hul'ter.iViu do 
this task yourself). In the following 
example we will he i h.m.nirij; the di-k 
name that we read with the previous 
example. See Fig. 3 



BLOCK-ALLOCATE 

When using Program, Sequential or 
Relative files on a disk, the BAM is 
beinc umslanlly updated as to blocks 
that are allocated. This prevents 
blocks from being overwritten. 
However, when we use Direct Access 
files, these are NOT allocated in the 
BAM. therefore there is a danger that 
they could be over-written. To 
prevent this from happening we can 
use the Block-Allocate command If 
we try to Allocate a block (hat has 
already been allocated, we will be 
given the error message 65, NO 
BLOCK,T,S (T and S are the next 
higher numbered free blocks 
available). ( 

allocate command is:- S B-A drive 
track sector The following ex.imple 
would mark track 1 7 sector 5 as being 
allocated in the BAM 

1 OPEN8,8,15 

2 PRINT#K,"B-A;"0;17;5 

BLOCK-FREE 

As indicated by it's name, this 
command frees any allocated blocks 
and marks Ihem in the BAM as being 

if you wished to make the above 
track and sector free to use you would 
use the following 

OPEN8.8,1 5 
PRINT#8."B-F:"0;1 7;5 



OPEN8.8.15 
OPEN4,8,4,"r 



CEW.TS.SS 

TR=ASt(T$-tCHR$(0)l:SE=ASC(SS+CHR$IO)) 



irTR=0THE NCLOSE4 CLOSE 8: E N D 
PRINTTrack number is: TR, "Sector number is: 
GOT04 



Open the command 
channel 

;Openslhe rliren access 
file,! no specific buffer) 
;TR,SE 

.■Reads contents of 
desired Track/Sector into 

:Reads the first two bytes 
of the buffer 
:Ci mverls siring; i.in.il >li- 
lo integer, allowing for 
null string 

:li last tfjck then finish 
; print them out 
;Repeal process 

FIGURE 1 



1 OPEN8,8,15 

2 OPEN4.B,4,"#" 

I PRINT#B,"U1:*4;0;1B;0 

4 PRINT#B,"B-P:"4;144 

5 F0RX=1T016 

6 GET#4.X$:IFX$=CHRSI1i 

7 PRINTX$:NEXT 

8 CLOSE4 



;Open command channel 

;Open direct access file 

.Read contents, of desired 

Track/sector into buffer 

;Point lo where we want to start 

leading from 

:Length of disk name 

:li ■.hilled space end 

;prinl out,read next letter 

:CLOSE8:END 



1 OPEN6,8,IS 

2 OPEN4,8,4,"# N 

3 PRINT#8."Ul:~4;0;ia;0 

4 PRINT»8,"B-p:"4;144 

5 X$="NEW DISK NAME" 

6 IFLENlXS)<16THENXS=X$+CHRJ(160>;GOTO6 

7 PRINT#4,XS; Change the contents 

of the buffer 

fi PRINT#H,"U2:"4;0;lfl;0 ;Write contents back 

to disk 

9 PRINT#8,"l":CLOSE4:tL05E8:END ^Reinitialize drive 

anil finish 
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NOTE: Allocating and freeing blocks 
hat an effect only on blocks that are 
used by Prg.seq and rel files by the 
DOS. The B-W and B-R commands 
do no! check the BAM before 
overwriting blocks. Using these 
commands you can wriie io blocks 
marked as allocated in the BAM. If, 
for instance, you have a disk that 

unnecessary In ,ill<>< ,nt- written bloi k^ 
because no other files will be written 
on the diskette. Therefore in this case 
you could use'the directory blocks in 
track IB and therefore have 672 
bloi ks available on the diskette. 

To give you an example ut Ihe use 
of this. One could store a menu 
(jrngiani onto traik 1H. thus spai e on 
the diskette is not wasted by the 



BLOCK-EXECUTE 

Hlotk-exeiulu is u-ed when von wish 
to read a block from ihe disk into a 
buffer then execute the contents as a 
machine code program. The syntax 
for the command is: B E channel drive 
track sector. When using the B-E 
command, the buffer number is 
usually given in the OPEN command, 
just in case the M/C prog is not 
relocatable. IE: OPEN4,8,4,"#2". 

1 OPENB,8,15 

2 OPEN4,8,4,"#2" 

3 PRINT#8."B-E:"4;0;14;t, 

This would read the contents of track 14, 
sector 6 The B E command is used in 
i onjurn lion with iiie B-R jml Mtm >rv 
Execute commands that follow. 

MEMORY COMMANDS 

There are three memory commands 
that we will deal with. They are 
Memory Read, IM-Rl Memory write, 
IM-W) and Memory execute, IM-EI. 
All these commands ore-supposes are 
knowledge of the inner workings of 
the DOS and a knowledge of 
6502/&510code. 

The syntax for the Memory read 
command is:- 

M-RCHRS(LO) CHR$[HI) 
IICHRSfnumberll 



CHR$(lO) is the low byte of the 
address In DOS that is to be read. 
CHRS(HI) is Ihe high byte of the 
address in DOS that is to be read. 
CH R$l. number) is the OPTIONAL 
extra parameter indicating how many 
bytes to read. 

In the following two examples, 
example 1 shows how to read how 
many free blocks are remaining on 
the disk. Example 2 shows how to 
read the disk name. 

1 OPEN8.8.15 

2 PRINT#B,'M-R~CHR$(250> 
CHRSI2) 

3 GET#8,XS:IFXS=""THENXS= 
CHR$(Ot 

4 PR1NT#8,"M-RTHRS(252) 
CHR$(2) 

5 GET#B,YS:IFVS=~"THENY$=CHR 
SI.O) 

6 PRINTASQXSI+^Sb'ASGYil 

7 CLOSES 

1 OPENB.8,15 

2 PRINT#B,"M-RXHR$(144)CHRS 
(7)CHRSI1fi) 

3 INPUT#H,X$ 

4 PRINTX$ 

5 CLOSEfl 

Memory write is the complimentary 
command to Memory read. Writing can 
only be accomplished to DOS Ram, 
page zero, stack and the buffers. It is 
possible to send more than I byte with 
Ihis (ommanrl. The command syntax is 
as follow: 

M-WCHRViLOlCHRStHI) 
CH RSI NUMBER! CHRSIDATA] 
CHRSIDATA) etc etc- 

Finally, the Memory execute command 
will i all up .lixl exti ute a machine code 
program that resides in DOS memory. 
The routine MUST end with an RTS. The 
syntax U« tlie i oiniikind is as follows:- 

M-E CHRS(LO) CHRJIHII 

You can not only execute your own 
routines written with the use of the M-W 
command, but also the DOS ROM 

So now that we have skirted the 
subject of Direct Access and Memory 
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commands, just whal exactly is possible. 
The following table list just a few ideas 
that readily spring lo mind:- 

A You ran manipulate the sectors 

ami change the BAM 
B. You ran make changes to the 

Di rectory 
C You can make changes to files 

D. You can protect tiles from 
accidental erasure 

E. YoucanaoSEIilesthatarestill 
OPE Ned 

F. You can read and alter any sector 
that you desire 

G. You can prevent directories from 
being viewed 

H. You can prevent directories from 
being loaded into memory 

I. You can recover lost or damaged 
files 

i You can create data structures lhal 
the DOS would not normally 

K. You could place a menu program 

within thedireclory track.ttius 

saving space 
L. You could put a simple form of 

'Protection' on ihe disk to prevent 

illegal pirating ol a lile. 

Really the list is boundless. Only your 
own imagination will set the limits of 
what can be achieved by the use of tliese 
commands. I cannot stress the 
importance ol making sure you do not 
u*> important disk- ior your ex|)erinviitv 
As you are no doubt aware, the 1 S41 
uses the OCR, IGroup Coded Recording), 
inelhnd ol storing data onto the disk. II 
you want to know more aboul this 
method, I refer you to 'Your 
Commodore', issue Jl_ 1 rsl E T-IOh, page 
75-77. All I will say on the subject is lhal 
by using this method, more inlormalion 
can be stored on the disk than you think 

I hope that this article as given you a 
h'ltcr u™k j ist.i ruling ol the 1541, and of 
how to use iL There are many things thai 
I have left out, but these are all covered 
by the many publications thai you can 
buy. There is not enough space here lo 
explain everything in detail, Study the 
listings of some of the programs in ihis 
issued, and ol previous issui^s. Practice 
Experiment but above all else.. .Have 
fun!!! 
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rUDISKUSER-l 








CLASSIFIED DEPARTMENT 

ALPHAVITE PUBLICATIONS LTD., 20 POTTERS LANE, Kl 
KEYNES MK11 3HF 

(0908)569819 


N FARM, MILTON 



FOOTBALL BOX FORM £14.95 cass £17.95 disk 

Nol a gimmicky plaything but a genuine statistical analysis of 
football form ttie sole objective of which is to improve the chances 
of winning on the pools or fixed odds. Written by a pools expert 
the program has forecast over 50% more draws than would 
be expected by chance. Homes, aways & draws are shown in 
order of merit and true odds given for every match. Merit tables 
show at a glance the teams currently in form and those having a 
lean spell. Separate AUSTRALIAN POOLS program included in the 

RACING BOX FORM & HANDICAP WINNER 
£14.95 cass £17.95 disk 

Two programmes for the price of one. Boxform weighs up a race by 
considering the many facets of form, Easily amended lo suit the 
user's ideas. HANDICAP WINNER shows (he value for money bets. 
Over 1000 winners every year and ON DERBY DAV 1990 THE 
PROGRAM GAVE THE WINNERS OF 7 OUT OF 9 HANDICAPS. 20/1 
10/1 7/1 11/2 4/1 4/1 6/4. PROBABLY THE BEST DAY'S RESULTS 
EVER ACHIEVED, WITH OR WITHOUT A COMPUTER. 



Why pay inflated prices? BOXoft CLEVER the same - get the BEST 
Advertised tor live years in the sporting and computer press, 
BOXOFT (CDU), 65 Allans Meadow, Neston, 
South Wlrral, L84 9 SO 
Cheque/RO./Access/Visa Teh 051-336-2668 (24 hrs) 




FULL TERMS 
AND CONDITIONS 
ARE AVAILABLE 

ON REQUEST 
TO ADVERTISE 

RING 
(0908) 569819 



DISK-USER 



PLEASE DEBIT MY ACCESS/VISA CARD N I 



Adventu ro 




Fed up with listings, want a break from programming? Then 
we've got just the thing for you. 
Were offering the following games on two cassettes at 
the ridiculously low price of £3 (for both) including 
post and packing. 
So what's on offer? 
Flimbo's quest, Finders keepers, Kentilla, Logic, Microdot, 

Rainbow chaser, Spots all these plus instructions. 

Al you have to do is fill in the coupon, (photocopies 

accepted) and return it to 

ALPHAVITE PUBLICATIONS Ltd, 20 Potters Lane, Kiln Farm, 
Milton Keynes MK11 3HF. 



J 



I enclose my cheque/postal order lor C3 made payable 
Or debit my Access/Visa Number Q 
Expiry Date 



i ALPHAVITE PUBLICATIONS LTD. 



I I I I I 



Signatur 



Allow 28 days for delivery 



